@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
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"finding-workflow.js","sourceRoot":"","sources":["../src/finding-workflow.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { isAbsolute, relative, sep } from \"node:path\";\nimport type { JsonObject } from \"./config.js\";\nimport { CodexSecurityError, errorMessage } from \"./errors.js\";\nimport type { FindingSearchScope } from \"./finding-retrieval.js\";\nimport {\n bundledPluginRoot,\n canonicalizeModelSafePath,\n codexSecurityStateDirectory,\n workbenchEnvironment,\n resolvePluginPython,\n runWorkbench,\n type WorkbenchCommandOptions,\n} from \"./runtime.js\";\n\nexport type WorkflowStage = \"scan\" | \"publish\" | \"dedupe\";\nexport interface WorkflowBinding {\n repositoryPath?: string;\n scanRequestDigest?: string;\n scanId?: string;\n scanDir?: string;\n artifactDigest?: string;\n destination?: string;\n scope?: FindingSearchScope;\n}\nexport interface WorkflowState extends WorkflowBinding {\n id: string;\n stages: Record<\n WorkflowStage,\n {\n status: \"pending\" | \"running\" | \"failed\" | \"completed\";\n result?: unknown;\n error?: string;\n pendingWrite?: { groups: string[][] };\n }\n >;\n}\n\nexport function workflowDigest(value: unknown): string {\n const json = JSON.stringify(value, (_key, item: unknown) =>\n item !== null && typeof item === \"object\" && !Array.isArray(item)\n ? Object.fromEntries(\n Object.entries(item).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0)),\n )\n : item,\n );\n return createHash(\"sha256\").update(json).digest(\"hex\");\n}\n\nexport function workflowDestination(url: string): string {\n const route = \"v1/bulk/findings\";\n const destination = new URL(route, url.endsWith(\"/\") ? url : `${url}/`);\n destination.username = \"\";\n destination.password = \"\";\n return destination.href.slice(0, -route.length);\n}\n\n/** State lives in the workbench database, never in sealed scan artifacts. */\nexport class FindingWorkflow {\n private options?: Promise<WorkbenchCommandOptions>;\n\n constructor(\n readonly id: string,\n private readonly environment: NodeJS.ProcessEnv = process.env,\n private readonly workbench: typeof runWorkbench = runWorkbench,\n private readonly pythonPath?: string,\n ) {\n if (!id.trim())\n throw new CodexSecurityError(\"workflowId must be a nonempty string.\");\n }\n\n async protectArtifacts(scanDir: string): Promise<void> {\n const path = relative(\n await canonicalizeModelSafePath(scanDir),\n await canonicalizeModelSafePath(\n codexSecurityStateDirectory(this.environment),\n ),\n );\n if (\n path === \"\" ||\n (!isAbsolute(path) && path !== \"..\" && !path.startsWith(`..${sep}`))\n ) {\n throw new CodexSecurityError(\n \"Workflow state must be outside the sealed scan artifacts.\",\n );\n }\n }\n\n async get(): Promise<WorkflowState | null> {\n return (await this.command({ action: \"get\" })) as WorkflowState | null;\n }\n\n async bind(binding: WorkflowBinding): Promise<WorkflowState> {\n return (await this.command({ action: \"bind\", binding }))!;\n }\n\n async begin(stage: WorkflowStage): Promise<WorkflowState> {\n return (await this.command({ action: \"begin\", stage }))!;\n }\n\n async complete(\n stage: WorkflowStage,\n result: unknown,\n ): Promise<WorkflowState> {\n return (await this.command({ action: \"complete\", stage, result }))!;\n }\n\n async fail(stage: WorkflowStage, error: unknown): Promise<void> {\n await this.command({\n action: \"fail\",\n stage,\n error: errorMessage(error),\n }).catch(() => undefined);\n }\n\n async run<T>(stage: WorkflowStage, operation: () => Promise<T>): Promise<T> {\n const state = await this.begin(stage);\n if (state.stages[stage].status === \"completed\")\n return state.stages[stage].result as T;\n try {\n const result = await operation();\n await this.complete(stage, result);\n return result;\n } catch (error) {\n await this.fail(stage, error);\n throw error;\n }\n }\n\n async registeredScan(scanId: string): Promise<JsonObject> {\n const context = await this.call([\"get-scan\", \"--scan-id\", scanId]);\n return context[\"scan\"] as JsonObject;\n }\n\n async sourceSnapshot(repository: string): Promise<JsonObject> {\n return (await this.request({ action: \"source\", repository }))[\n \"source\"\n ] as JsonObject;\n }\n\n async getReview(key: string): Promise<unknown> {\n return (await this.request({ action: \"get-review\", key }))[\"review\"];\n }\n\n async saveReview(\n key: string,\n binding: object,\n result: unknown,\n ): Promise<void> {\n await this.request({ action: \"save-review\", key, binding, result });\n }\n\n async prepareDedupe(\n result: unknown,\n pendingWrite: { groups: string[][] },\n ): Promise<void> {\n await this.command({\n action: \"prepare-dedupe\",\n stage: \"dedupe\",\n result,\n pendingWrite,\n });\n }\n\n private async command(payload: object): Promise<WorkflowState | null> {\n const result = await this.request(payload);\n return result[\"workflow\"] as unknown as WorkflowState | null;\n }\n\n private async request(payload: object): Promise<JsonObject> {\n return await this.call(\n [\"finding-workflow\"],\n JSON.stringify({ id: this.id, ...payload }),\n );\n }\n\n private async call(\n args: readonly string[],\n input?: string,\n ): Promise<JsonObject> {\n this.options ??= (async () => ({\n pluginRoot: await bundledPluginRoot(),\n python: await resolvePluginPython({\n environment: this.environment,\n configuredPath: this.pythonPath,\n }),\n environment: workbenchEnvironment(this.environment),\n failureMessage: \"Could not save or resume the findings workflow\",\n }))();\n return await this.workbench(await this.options, args, input);\n }\n}\n"]}
|
|
1
|
+
{"version":3,"file":"finding-workflow.js","sourceRoot":"","sources":["../src/finding-workflow.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { isAbsolute, relative, sep } from \"node:path\";\nimport type { JsonObject } from \"./config.js\";\nimport { CodexSecurityError, errorMessage } from \"./errors.js\";\nimport { findingsBaseUrl } from \"./findings-client.js\";\nimport type { FindingSearchScope } from \"./finding-retrieval.js\";\nimport {\n bundledPluginRoot,\n canonicalizeModelSafePath,\n codexSecurityStateDirectory,\n workbenchEnvironment,\n resolvePluginPython,\n runWorkbench,\n type WorkbenchCommandOptions,\n} from \"./runtime.js\";\n\nexport type WorkflowStage = \"scan\" | \"publish\" | \"dedupe\";\nexport interface WorkflowBinding {\n repositoryPath?: string;\n scanRequestDigest?: string;\n scanId?: string;\n scanDir?: string;\n artifactDigest?: string;\n destination?: string;\n scope?: FindingSearchScope;\n}\nexport interface WorkflowState extends WorkflowBinding {\n id: string;\n stages: Record<\n WorkflowStage,\n {\n status: \"pending\" | \"running\" | \"failed\" | \"completed\";\n result?: unknown;\n error?: string;\n pendingWrite?: DedupePendingWrite;\n }\n >;\n}\n\nexport interface DedupePendingWrite {\n groups: string[][];\n local?: { inputDigest: string; source: JsonObject; gitDisabled?: boolean };\n}\n\nexport function workflowDigest(value: unknown): string {\n const json = JSON.stringify(value, (_key, item: unknown) =>\n item !== null && typeof item === \"object\" && !Array.isArray(item)\n ? Object.fromEntries(\n Object.entries(item).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0)),\n )\n : item,\n );\n return createHash(\"sha256\").update(json).digest(\"hex\");\n}\n\nexport function workflowDestination(url: string): string {\n const destination = findingsBaseUrl(url);\n destination.username = \"\";\n destination.password = \"\";\n return destination.href;\n}\n\n/** State lives in the workbench database, never in sealed scan artifacts. */\nexport class FindingWorkflow {\n private options?: Promise<WorkbenchCommandOptions>;\n\n constructor(\n readonly id: string,\n private readonly environment: NodeJS.ProcessEnv = process.env,\n private readonly workbench: typeof runWorkbench = runWorkbench,\n private readonly pythonPath?: string,\n private readonly protectedRoot?: string,\n ) {\n if (!id.trim())\n throw new CodexSecurityError(\"workflowId must be a nonempty string.\");\n }\n\n async protectArtifacts(scanDir: string): Promise<void> {\n const path = relative(\n await canonicalizeModelSafePath(scanDir),\n await canonicalizeModelSafePath(\n codexSecurityStateDirectory(this.environment),\n ),\n );\n if (\n path === \"\" ||\n (!isAbsolute(path) && path !== \"..\" && !path.startsWith(`..${sep}`))\n ) {\n throw new CodexSecurityError(\n \"Workflow state must be outside the sealed scan artifacts.\",\n );\n }\n }\n\n async get(): Promise<WorkflowState | null> {\n return (await this.command({ action: \"get\" })) as WorkflowState | null;\n }\n\n async bind(binding: WorkflowBinding): Promise<WorkflowState> {\n return (await this.command({ action: \"bind\", binding }))!;\n }\n\n async begin(stage: WorkflowStage): Promise<WorkflowState> {\n return (await this.command({ action: \"begin\", stage }))!;\n }\n\n async complete(\n stage: WorkflowStage,\n result: unknown,\n ): Promise<WorkflowState> {\n return (await this.command({ action: \"complete\", stage, result }))!;\n }\n\n async fail(stage: WorkflowStage, error: unknown): Promise<void> {\n await this.command({\n action: \"fail\",\n stage,\n error: errorMessage(error),\n }).catch(() => undefined);\n }\n\n async run<T>(stage: WorkflowStage, operation: () => Promise<T>): Promise<T> {\n const state = await this.begin(stage);\n if (state.stages[stage].status === \"completed\")\n return state.stages[stage].result as T;\n try {\n const result = await operation();\n await this.complete(stage, result);\n return result;\n } catch (error) {\n await this.fail(stage, error);\n throw error;\n }\n }\n\n async registeredScan(scanId: string): Promise<JsonObject> {\n const context = await this.call([\"get-scan\", \"--scan-id\", scanId]);\n return context[\"scan\"] as JsonObject;\n }\n\n async sourceSnapshot(\n repository: string,\n gitDisabled = false,\n privateStatePaths: readonly string[] = [],\n ): Promise<JsonObject> {\n return (\n await this.request({\n action: \"source\",\n repository,\n ...(gitDisabled ? { gitDisabled } : {}),\n ...(privateStatePaths.length ? { privateStatePaths } : {}),\n })\n )[\"source\"] as JsonObject;\n }\n\n async getReview(key: string): Promise<unknown> {\n return (await this.request({ action: \"get-review\", key }))[\"review\"];\n }\n\n async saveReview(\n key: string,\n binding: object,\n result: unknown,\n ): Promise<void> {\n await this.request({ action: \"save-review\", key, binding, result });\n }\n\n async prepareDedupe(\n result: unknown,\n pendingWrite: DedupePendingWrite,\n ): Promise<void> {\n await this.command({\n action: \"prepare-dedupe\",\n stage: \"dedupe\",\n result,\n pendingWrite,\n });\n }\n\n private async command(payload: object): Promise<WorkflowState | null> {\n const result = await this.request(payload);\n return result[\"workflow\"] as unknown as WorkflowState | null;\n }\n\n private async request(payload: object): Promise<JsonObject> {\n return await this.call(\n [\"finding-workflow\"],\n JSON.stringify({ id: this.id, ...payload }),\n );\n }\n\n private async call(\n args: readonly string[],\n input?: string,\n ): Promise<JsonObject> {\n this.options ??= (async () => ({\n pluginRoot: await bundledPluginRoot(),\n python: await resolvePluginPython({\n environment: this.environment,\n configuredPath: this.pythonPath,\n protectedRoot: this.protectedRoot,\n }),\n environment: workbenchEnvironment(this.environment),\n failureMessage: \"Could not save or resume the findings workflow\",\n }))();\n return await this.workbench(await this.options, args, input);\n }\n}\n"]}
|
|
@@ -2,11 +2,12 @@ import { waitForRetry } from "./deduplication/retry.js";
|
|
|
2
2
|
import type { Finding } from "./models.js";
|
|
3
3
|
import type { FindingNeighborhood, FindingSearchScope } from "./finding-retrieval.js";
|
|
4
4
|
export type FindingsRequest = (url: URL, init: RequestInit) => Promise<Response>;
|
|
5
|
+
export declare function findingsBaseUrl(value: string): URL;
|
|
5
6
|
export declare class FindingsClient {
|
|
6
|
-
private readonly url;
|
|
7
7
|
private readonly signal?;
|
|
8
8
|
private readonly request;
|
|
9
9
|
private readonly retries;
|
|
10
|
+
private readonly url;
|
|
10
11
|
constructor(url: string, signal?: AbortSignal | undefined, request?: FindingsRequest, retries?: {
|
|
11
12
|
wait?: typeof waitForRetry;
|
|
12
13
|
random?: () => number;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"findings-client.d.ts","sourceRoot":"","sources":["../src/findings-client.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"findings-client.d.ts","sourceRoot":"","sources":["../src/findings-client.ts"],"names":[],"mappings":"AAKA,OAAO,EAAc,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,MAAM,eAAe,GAAG,CAC5B,GAAG,EAAE,GAAG,EACR,IAAI,EAAE,WAAW,KACd,OAAO,CAAC,QAAQ,CAAC,CAAC;AA+CvB,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAMlD;AAED,qBAAa,cAAc;IAIvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL1B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAM;IAC1B,YACE,GAAG,EAAE,MAAM,EACM,MAAM,CAAC,EAAE,WAAW,YAAA,EACpB,OAAO,GAAE,eAAuB,EAChC,OAAO,GAAE;QACxB,IAAI,CAAC,EAAE,OAAO,YAAY,CAAC;QAC3B,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;KAClB,EAGP;IAEK,mBAAmB,CACvB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CAsB9B;IAEK,OAAO,CACX,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,EAAE,CAAC,CAiBnB;IAEK,iBAAiB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAGlE;YAEa,KAAK;IAsBnB,OAAO,CAAC,QAAQ;YAIF,IAAI;CAgBnB"}
|
package/dist/findings-client.js
CHANGED
|
@@ -1,12 +1,33 @@
|
|
|
1
1
|
import { CodexSecurityError } from "./errors.js";
|
|
2
|
+
import { parseFindingsErrorResponse, } from "./findings-errors.js";
|
|
2
3
|
import { retryDelay, waitForRetry } from "./deduplication/retry.js";
|
|
3
4
|
class FindingsHttpError extends CodexSecurityError {
|
|
4
5
|
status;
|
|
5
6
|
retryAfter;
|
|
6
|
-
|
|
7
|
+
code;
|
|
8
|
+
constructor(message, status, retryAfter, code) {
|
|
7
9
|
super(message);
|
|
8
10
|
this.status = status;
|
|
9
11
|
this.retryAfter = retryAfter;
|
|
12
|
+
this.code = code;
|
|
13
|
+
}
|
|
14
|
+
static async fromResponse(response, message, signal) {
|
|
15
|
+
// Service errors are JSON; other gateway bodies need not finish to report HTTP failure.
|
|
16
|
+
const mediaType = response.headers
|
|
17
|
+
.get("Content-Type")
|
|
18
|
+
?.split(";", 1)[0]
|
|
19
|
+
?.trim()
|
|
20
|
+
.toLowerCase();
|
|
21
|
+
let body;
|
|
22
|
+
if (mediaType === "application/json" || mediaType?.endsWith("+json")) {
|
|
23
|
+
body = await response.json().catch(() => undefined);
|
|
24
|
+
}
|
|
25
|
+
else {
|
|
26
|
+
void response.body?.cancel().catch(() => undefined);
|
|
27
|
+
}
|
|
28
|
+
signal?.throwIfAborted();
|
|
29
|
+
const error = parseFindingsErrorResponse(body);
|
|
30
|
+
return new FindingsHttpError(error?.message ? `${message} ${error.message}` : message, response.status, response.headers.get("Retry-After"), error?.error);
|
|
10
31
|
}
|
|
11
32
|
}
|
|
12
33
|
function isRetryable(error) {
|
|
@@ -15,16 +36,24 @@ function isRetryable(error) {
|
|
|
15
36
|
// Fetch rejects network failures with TypeError; JSON truncation can produce SyntaxError.
|
|
16
37
|
return error instanceof TypeError || error instanceof SyntaxError;
|
|
17
38
|
}
|
|
39
|
+
export function findingsBaseUrl(value) {
|
|
40
|
+
const url = new URL(value);
|
|
41
|
+
if (!url.pathname.endsWith("/"))
|
|
42
|
+
url.pathname += "/";
|
|
43
|
+
url.search = "";
|
|
44
|
+
url.hash = "";
|
|
45
|
+
return url;
|
|
46
|
+
}
|
|
18
47
|
export class FindingsClient {
|
|
19
|
-
url;
|
|
20
48
|
signal;
|
|
21
49
|
request;
|
|
22
50
|
retries;
|
|
51
|
+
url;
|
|
23
52
|
constructor(url, signal, request = fetch, retries = {}) {
|
|
24
|
-
this.url = url;
|
|
25
53
|
this.signal = signal;
|
|
26
54
|
this.request = request;
|
|
27
55
|
this.retries = retries;
|
|
56
|
+
this.url = findingsBaseUrl(url);
|
|
28
57
|
}
|
|
29
58
|
async potentialDuplicates(findingId, scope) {
|
|
30
59
|
const url = this.endpoint(`v1/finding/${encodeURIComponent(findingId)}/potential-duplicates`);
|
|
@@ -35,10 +64,9 @@ export class FindingsClient {
|
|
|
35
64
|
return await this.retry(async () => {
|
|
36
65
|
const response = await this.request(url, { signal: this.signal });
|
|
37
66
|
if (!response.ok) {
|
|
38
|
-
await response.
|
|
39
|
-
throw new FindingsHttpError(`Potential-duplicates lookup for ${findingId} failed (HTTP ${response.status}).${response.status === 404
|
|
67
|
+
throw await FindingsHttpError.fromResponse(response, `Potential-duplicates lookup for ${findingId} failed (HTTP ${response.status}).${response.status === 404
|
|
40
68
|
? " Import the finding with its repositoryId through POST /v1/bulk/findings before deduplicating."
|
|
41
|
-
: ""}`,
|
|
69
|
+
: ""}`, this.signal);
|
|
42
70
|
}
|
|
43
71
|
return (await response.json());
|
|
44
72
|
});
|
|
@@ -86,7 +114,7 @@ export class FindingsClient {
|
|
|
86
114
|
}
|
|
87
115
|
}
|
|
88
116
|
endpoint(path) {
|
|
89
|
-
return new URL(path, this.url
|
|
117
|
+
return new URL(path, this.url);
|
|
90
118
|
}
|
|
91
119
|
async post(path, body) {
|
|
92
120
|
const response = await this.request(this.endpoint(path), {
|
|
@@ -96,8 +124,7 @@ export class FindingsClient {
|
|
|
96
124
|
signal: this.signal,
|
|
97
125
|
});
|
|
98
126
|
if (!response.ok) {
|
|
99
|
-
await
|
|
100
|
-
throw new FindingsHttpError(`Findings API POST /${path} failed (HTTP ${response.status}).`, response.status, response.headers.get("Retry-After"));
|
|
127
|
+
throw await FindingsHttpError.fromResponse(response, `Findings API POST /${path} failed (HTTP ${response.status}).`, this.signal);
|
|
101
128
|
}
|
|
102
129
|
return await response.json();
|
|
103
130
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"findings-client.js","sourceRoot":"","sources":["../src/findings-client.ts"],"names":[],"mappings":"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","sourcesContent":["import { CodexSecurityError } from \"./errors.js\";\nimport { retryDelay, waitForRetry } from \"./deduplication/retry.js\";\nimport type { Finding } from \"./models.js\";\nimport type {\n FindingNeighborhood,\n FindingSearchScope,\n} from \"./finding-retrieval.js\";\n\nexport type FindingsRequest = (\n url: URL,\n init: RequestInit,\n) => Promise<Response>;\n\nclass FindingsHttpError extends CodexSecurityError {\n constructor(\n message: string,\n readonly status: number,\n readonly retryAfter: string | null,\n ) {\n super(message);\n }\n}\n\nfunction isRetryable(error: unknown): boolean {\n if (error instanceof FindingsHttpError)\n return [408, 429, 500, 502, 503, 504].includes(error.status);\n // Fetch rejects network failures with TypeError; JSON truncation can produce SyntaxError.\n return error instanceof TypeError || error instanceof SyntaxError;\n}\n\nexport class FindingsClient {\n constructor(\n private readonly url: string,\n private readonly signal?: AbortSignal,\n private readonly request: FindingsRequest = fetch,\n private readonly retries: {\n wait?: typeof waitForRetry;\n random?: () => number;\n } = {},\n ) {}\n\n async potentialDuplicates(\n findingId: string,\n scope: FindingSearchScope,\n ): Promise<FindingNeighborhood> {\n const url = this.endpoint(\n `v1/finding/${encodeURIComponent(findingId)}/potential-duplicates`,\n );\n if (scope.allRepositories === true)\n url.searchParams.set(\"allRepositories\", \"true\");\n else url.searchParams.set(\"repositoryId\", scope.repositoryId);\n return await this.retry(async () => {\n const response = await this.request(url, { signal: this.signal });\n if (!response.ok) {\n await response.body?.cancel().catch(() => undefined);\n throw new FindingsHttpError(\n `Potential-duplicates lookup for ${findingId} failed (HTTP ${response.status}).${\n response.status === 404\n ? \" Import the finding with its repositoryId through POST /v1/bulk/findings before deduplicating.\"\n : \"\"\n }`,\n response.status,\n response.headers.get(\"Retry-After\"),\n );\n }\n return (await response.json()) as FindingNeighborhood;\n });\n }\n\n async publish(\n findings: readonly Finding[],\n repositoryId: string,\n ): Promise<string[]> {\n const receipt = await this.post(\"v1/bulk/findings\", {\n findings,\n repositoryId,\n });\n const expected = new Set(findings.map((finding) => finding.findingId));\n if (\n !Array.isArray(receipt) ||\n receipt.length !== findings.length ||\n new Set(receipt).size !== expected.size ||\n receipt.some((id) => !expected.has(id))\n ) {\n throw new CodexSecurityError(\n \"The findings API did not acknowledge all published finding IDs. Check the service before retrying.\",\n );\n }\n return receipt as string[];\n }\n\n async storeDedupeGroups(groups: readonly string[][]): Promise<void> {\n if (groups.length === 0) return;\n await this.retry(() => this.post(\"v1/dedupe-groups\", { groups }));\n }\n\n private async retry<T>(operation: () => Promise<T>): Promise<T> {\n for (let attempt = 1; ; attempt++) {\n this.signal?.throwIfAborted();\n try {\n return await operation();\n } catch (error) {\n this.signal?.throwIfAborted();\n if (attempt === 3 || !isRetryable(error)) throw error;\n let delay = retryDelay(attempt, this.retries.random);\n if (error instanceof FindingsHttpError && error.retryAfter !== null) {\n const seconds = Number(error.retryAfter);\n const serverDelay = Number.isFinite(seconds)\n ? seconds * 1000\n : Date.parse(error.retryAfter) - Date.now();\n if (Number.isFinite(serverDelay))\n delay = Math.max(delay, serverDelay);\n }\n await (this.retries.wait ?? waitForRetry)(delay, this.signal);\n }\n }\n }\n\n private endpoint(path: string): URL {\n return new URL(path, this.url.endsWith(\"/\") ? this.url : `${this.url}/`);\n }\n\n private async post(path: string, body: unknown): Promise<unknown> {\n const response = await this.request(this.endpoint(path), {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/json\" },\n body: JSON.stringify(body),\n signal: this.signal,\n });\n if (!response.ok) {\n await response.body?.cancel().catch(() => undefined);\n throw new FindingsHttpError(\n `Findings API POST /${path} failed (HTTP ${response.status}).`,\n response.status,\n response.headers.get(\"Retry-After\"),\n );\n }\n return await response.json();\n }\n}\n"]}
|
|
1
|
+
{"version":3,"file":"findings-client.js","sourceRoot":"","sources":["../src/findings-client.ts"],"names":[],"mappings":"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","sourcesContent":["import { CodexSecurityError } from \"./errors.js\";\nimport {\n parseFindingsErrorResponse,\n type FindingsErrorCode,\n} from \"./findings-errors.js\";\nimport { retryDelay, waitForRetry } from \"./deduplication/retry.js\";\nimport type { Finding } from \"./models.js\";\nimport type {\n FindingNeighborhood,\n FindingSearchScope,\n} from \"./finding-retrieval.js\";\n\nexport type FindingsRequest = (\n url: URL,\n init: RequestInit,\n) => Promise<Response>;\n\nclass FindingsHttpError extends CodexSecurityError {\n constructor(\n message: string,\n readonly status: number,\n readonly retryAfter: string | null,\n readonly code?: FindingsErrorCode,\n ) {\n super(message);\n }\n\n static async fromResponse(\n response: Response,\n message: string,\n signal?: AbortSignal,\n ): Promise<FindingsHttpError> {\n // Service errors are JSON; other gateway bodies need not finish to report HTTP failure.\n const mediaType = response.headers\n .get(\"Content-Type\")\n ?.split(\";\", 1)[0]\n ?.trim()\n .toLowerCase();\n let body: unknown;\n if (mediaType === \"application/json\" || mediaType?.endsWith(\"+json\")) {\n body = await response.json().catch(() => undefined);\n } else {\n void response.body?.cancel().catch(() => undefined);\n }\n signal?.throwIfAborted();\n const error = parseFindingsErrorResponse(body);\n return new FindingsHttpError(\n error?.message ? `${message} ${error.message}` : message,\n response.status,\n response.headers.get(\"Retry-After\"),\n error?.error,\n );\n }\n}\n\nfunction isRetryable(error: unknown): boolean {\n if (error instanceof FindingsHttpError)\n return [408, 429, 500, 502, 503, 504].includes(error.status);\n // Fetch rejects network failures with TypeError; JSON truncation can produce SyntaxError.\n return error instanceof TypeError || error instanceof SyntaxError;\n}\n\nexport function findingsBaseUrl(value: string): URL {\n const url = new URL(value);\n if (!url.pathname.endsWith(\"/\")) url.pathname += \"/\";\n url.search = \"\";\n url.hash = \"\";\n return url;\n}\n\nexport class FindingsClient {\n private readonly url: URL;\n constructor(\n url: string,\n private readonly signal?: AbortSignal,\n private readonly request: FindingsRequest = fetch,\n private readonly retries: {\n wait?: typeof waitForRetry;\n random?: () => number;\n } = {},\n ) {\n this.url = findingsBaseUrl(url);\n }\n\n async potentialDuplicates(\n findingId: string,\n scope: FindingSearchScope,\n ): Promise<FindingNeighborhood> {\n const url = this.endpoint(\n `v1/finding/${encodeURIComponent(findingId)}/potential-duplicates`,\n );\n if (scope.allRepositories === true)\n url.searchParams.set(\"allRepositories\", \"true\");\n else url.searchParams.set(\"repositoryId\", scope.repositoryId);\n return await this.retry(async () => {\n const response = await this.request(url, { signal: this.signal });\n if (!response.ok) {\n throw await FindingsHttpError.fromResponse(\n response,\n `Potential-duplicates lookup for ${findingId} failed (HTTP ${response.status}).${\n response.status === 404\n ? \" Import the finding with its repositoryId through POST /v1/bulk/findings before deduplicating.\"\n : \"\"\n }`,\n this.signal,\n );\n }\n return (await response.json()) as FindingNeighborhood;\n });\n }\n\n async publish(\n findings: readonly Finding[],\n repositoryId: string,\n ): Promise<string[]> {\n const receipt = await this.post(\"v1/bulk/findings\", {\n findings,\n repositoryId,\n });\n const expected = new Set(findings.map((finding) => finding.findingId));\n if (\n !Array.isArray(receipt) ||\n receipt.length !== findings.length ||\n new Set(receipt).size !== expected.size ||\n receipt.some((id) => !expected.has(id))\n ) {\n throw new CodexSecurityError(\n \"The findings API did not acknowledge all published finding IDs. Check the service before retrying.\",\n );\n }\n return receipt as string[];\n }\n\n async storeDedupeGroups(groups: readonly string[][]): Promise<void> {\n if (groups.length === 0) return;\n await this.retry(() => this.post(\"v1/dedupe-groups\", { groups }));\n }\n\n private async retry<T>(operation: () => Promise<T>): Promise<T> {\n for (let attempt = 1; ; attempt++) {\n this.signal?.throwIfAborted();\n try {\n return await operation();\n } catch (error) {\n this.signal?.throwIfAborted();\n if (attempt === 3 || !isRetryable(error)) throw error;\n let delay = retryDelay(attempt, this.retries.random);\n if (error instanceof FindingsHttpError && error.retryAfter !== null) {\n const seconds = Number(error.retryAfter);\n const serverDelay = Number.isFinite(seconds)\n ? seconds * 1000\n : Date.parse(error.retryAfter) - Date.now();\n if (Number.isFinite(serverDelay))\n delay = Math.max(delay, serverDelay);\n }\n await (this.retries.wait ?? waitForRetry)(delay, this.signal);\n }\n }\n }\n\n private endpoint(path: string): URL {\n return new URL(path, this.url);\n }\n\n private async post(path: string, body: unknown): Promise<unknown> {\n const response = await this.request(this.endpoint(path), {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/json\" },\n body: JSON.stringify(body),\n signal: this.signal,\n });\n if (!response.ok) {\n throw await FindingsHttpError.fromResponse(\n response,\n `Findings API POST /${path} failed (HTTP ${response.status}).`,\n this.signal,\n );\n }\n return await response.json();\n }\n}\n"]}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
export declare const FINDINGS_ERROR_STATUS: {
|
|
2
|
+
readonly invalid_request: 400;
|
|
3
|
+
readonly finding_conflict: 409;
|
|
4
|
+
readonly embedding_unavailable: 503;
|
|
5
|
+
readonly embedding_failed: 502;
|
|
6
|
+
readonly finding_not_indexed: 404;
|
|
7
|
+
readonly not_found: 404;
|
|
8
|
+
readonly internal_error: 500;
|
|
9
|
+
};
|
|
10
|
+
export type FindingsErrorCode = keyof typeof FINDINGS_ERROR_STATUS;
|
|
11
|
+
export interface FindingsErrorResponse {
|
|
12
|
+
error: FindingsErrorCode;
|
|
13
|
+
message?: string;
|
|
14
|
+
}
|
|
15
|
+
export declare function parseFindingsErrorResponse(value: unknown): FindingsErrorResponse | undefined;
|
|
16
|
+
//# sourceMappingURL=findings-errors.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"findings-errors.d.ts","sourceRoot":"","sources":["../src/findings-errors.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB;aAChC,eAAe,EAAE,GAAG;aACpB,gBAAgB,EAAE,GAAG;aACrB,qBAAqB,EAAE,GAAG;aAC1B,gBAAgB,EAAE,GAAG;aACrB,mBAAmB,EAAE,GAAG;aACxB,SAAS,EAAE,GAAG;aACd,cAAc,EAAE,GAAG;CACX,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,qBAAqB,CAAC;AAEnE,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,iBAAiB,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,GACb,qBAAqB,GAAG,SAAS,CAenC"}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
export const FINDINGS_ERROR_STATUS = {
|
|
2
|
+
invalid_request: 400,
|
|
3
|
+
finding_conflict: 409,
|
|
4
|
+
embedding_unavailable: 503,
|
|
5
|
+
embedding_failed: 502,
|
|
6
|
+
finding_not_indexed: 404,
|
|
7
|
+
not_found: 404,
|
|
8
|
+
internal_error: 500,
|
|
9
|
+
};
|
|
10
|
+
export function parseFindingsErrorResponse(value) {
|
|
11
|
+
if (typeof value !== "object" ||
|
|
12
|
+
value === null ||
|
|
13
|
+
!("error" in value) ||
|
|
14
|
+
typeof value.error !== "string" ||
|
|
15
|
+
!Object.hasOwn(FINDINGS_ERROR_STATUS, value.error) ||
|
|
16
|
+
("message" in value && typeof value.message !== "string")) {
|
|
17
|
+
return undefined;
|
|
18
|
+
}
|
|
19
|
+
return {
|
|
20
|
+
error: value.error,
|
|
21
|
+
...("message" in value ? { message: value.message } : {}),
|
|
22
|
+
};
|
|
23
|
+
}
|
|
24
|
+
//# sourceMappingURL=findings-errors.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"findings-errors.js","sourceRoot":"","sources":["../src/findings-errors.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,eAAe,EAAE,GAAG;IACpB,gBAAgB,EAAE,GAAG;IACrB,qBAAqB,EAAE,GAAG;IAC1B,gBAAgB,EAAE,GAAG;IACrB,mBAAmB,EAAE,GAAG;IACxB,SAAS,EAAE,GAAG;IACd,cAAc,EAAE,GAAG;CACX,CAAC;AASX,MAAM,UAAU,0BAA0B,CACxC,KAAc;IAEd,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,CAAC,CAAC,OAAO,IAAI,KAAK,CAAC;QACnB,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;QAC/B,CAAC,MAAM,CAAC,MAAM,CAAC,qBAAqB,EAAE,KAAK,CAAC,KAAK,CAAC;QAClD,CAAC,SAAS,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,EACzD,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,KAA0B;QACvC,GAAG,CAAC,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpE,CAAC;AACJ,CAAC","sourcesContent":["export const FINDINGS_ERROR_STATUS = {\n invalid_request: 400,\n finding_conflict: 409,\n embedding_unavailable: 503,\n embedding_failed: 502,\n finding_not_indexed: 404,\n not_found: 404,\n internal_error: 500,\n} as const;\n\nexport type FindingsErrorCode = keyof typeof FINDINGS_ERROR_STATUS;\n\nexport interface FindingsErrorResponse {\n error: FindingsErrorCode;\n message?: string;\n}\n\nexport function parseFindingsErrorResponse(\n value: unknown,\n): FindingsErrorResponse | undefined {\n if (\n typeof value !== \"object\" ||\n value === null ||\n !(\"error\" in value) ||\n typeof value.error !== \"string\" ||\n !Object.hasOwn(FINDINGS_ERROR_STATUS, value.error) ||\n (\"message\" in value && typeof value.message !== \"string\")\n ) {\n return undefined;\n }\n return {\n error: value.error as FindingsErrorCode,\n ...(\"message\" in value ? { message: value.message as string } : {}),\n };\n}\n"]}
|
|
@@ -39,6 +39,6 @@ type CsvFindingRow = z.infer<typeof csvFindingRowSchema>;
|
|
|
39
39
|
export declare function parseImportedFindings(source: string, format: FindingsImportFormat, pluginRoot: string): Promise<Finding[]>;
|
|
40
40
|
export declare function bindImportedFindings(findings: Finding[], format: FindingsImportFormat, scanId: string, targetId: string): Finding[];
|
|
41
41
|
export declare function parseFindingsCsv(source: string): CsvFindingRow[];
|
|
42
|
-
export declare function csvRowFinding(row: CsvFindingRow
|
|
42
|
+
export declare function csvRowFinding(row: CsvFindingRow): Finding;
|
|
43
43
|
export {};
|
|
44
44
|
//# sourceMappingURL=findings-import.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"findings-import.d.ts","sourceRoot":"","sources":["../src/findings-import.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"findings-import.d.ts","sourceRoot":"","sources":["../src/findings-import.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,OAAO,EAAoB,MAAM,aAAa,CAAC;AAE7D,eAAO,MAAM,aAAa,8BAA8B,CAAC;AACzD,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,MAAM,CAAC;AAKlD,QAAA,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkFrB,CAAC;AACL,KAAK,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAOzD,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,oBAAoB,EAC5B,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,EAAE,CAAC,CAsDpB;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,OAAO,EAAE,EACnB,MAAM,EAAE,oBAAoB,EAC5B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,EAAE,CA6BX;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,EAAE,CAiDhE;AAMD,wBAAgB,aAAa,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAmDzD"}
|
package/dist/findings-import.js
CHANGED
|
@@ -1,10 +1,11 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { isRecord } from "./record.js";
|
|
2
|
+
import { deriveFindingIdentity, sha256Text as sha256 } from "./contract.js";
|
|
2
3
|
import { readFile } from "node:fs/promises";
|
|
3
4
|
import { isAbsolute, join, posix } from "node:path";
|
|
4
5
|
import Ajv2020 from "ajv/dist/2020.js";
|
|
5
6
|
import { z } from "incur";
|
|
6
7
|
import Papa from "papaparse";
|
|
7
|
-
import { CodexSecurityError } from "./errors.js";
|
|
8
|
+
import { CodexSecurityError, errorMessage } from "./errors.js";
|
|
8
9
|
export const CSV_TARGET_ID = "codex-security-csv-import";
|
|
9
10
|
// Match the Python exporter's str.lstrip(), including its extra C0 separators.
|
|
10
11
|
const EXPORTED_CSV_ESCAPE = /^'(?:['\t\r\n]|[\p{White_Space}\u001c-\u001f]*[=+\-@=+-@])/u;
|
|
@@ -86,11 +87,7 @@ const CSV_COLUMNS = Object.keys(csvFindingRowSchema.shape);
|
|
|
86
87
|
const REQUIRED_CSV_COLUMNS = CSV_COLUMNS.filter((column) => !csvFindingRowSchema.shape[column].isOptional());
|
|
87
88
|
export async function parseImportedFindings(source, format, pluginRoot) {
|
|
88
89
|
if (format === "csv") {
|
|
89
|
-
return parseFindingsCsv(source).map(
|
|
90
|
-
...csvRowFinding(row, "import"),
|
|
91
|
-
findingId: row.finding_id,
|
|
92
|
-
occurrenceId: row.occurrence_id,
|
|
93
|
-
}));
|
|
90
|
+
return parseFindingsCsv(source).map(csvRowFinding);
|
|
94
91
|
}
|
|
95
92
|
let payload;
|
|
96
93
|
try {
|
|
@@ -99,13 +96,9 @@ export async function parseImportedFindings(source, format, pluginRoot) {
|
|
|
99
96
|
payload = JSON.parse(source.replace(/^\uFEFF/u, ""));
|
|
100
97
|
}
|
|
101
98
|
catch (error) {
|
|
102
|
-
throw new CodexSecurityError(
|
|
103
|
-
cause: error,
|
|
104
|
-
});
|
|
99
|
+
throw new CodexSecurityError(`Findings JSON could not be parsed. ${errorMessage(error)}`, { cause: error });
|
|
105
100
|
}
|
|
106
|
-
if (payload
|
|
107
|
-
typeof payload !== "object" ||
|
|
108
|
-
Array.isArray(payload)) {
|
|
101
|
+
if (!isRecord(payload)) {
|
|
109
102
|
throw new CodexSecurityError("Findings JSON must contain a findings document or an object with a findings array.");
|
|
110
103
|
}
|
|
111
104
|
const hasDocumentMetadata = ["documentType", "schemaVersion", "scanId"].some((key) => Object.hasOwn(payload, key));
|
|
@@ -134,22 +127,14 @@ export async function parseImportedFindings(source, format, pluginRoot) {
|
|
|
134
127
|
}
|
|
135
128
|
export function bindImportedFindings(findings, format, scanId, targetId) {
|
|
136
129
|
return findings.map((finding) => {
|
|
137
|
-
const ruleId = `import.${format}`;
|
|
138
|
-
const anchor = finding.occurrenceId;
|
|
139
|
-
const fingerprint = `codex-security/v1:sha256:${sha256(["codex-security/v1", targetId, ruleId, anchor, ""].join("\0"))}`;
|
|
140
130
|
// A source report path names another scan's artifact. Preserve it as
|
|
141
131
|
// provenance without treating the imported path as permission to read it.
|
|
142
132
|
const { writeup, ...content } = finding;
|
|
143
133
|
return {
|
|
144
134
|
...content,
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
identity: { anchor },
|
|
149
|
-
fingerprints: {
|
|
150
|
-
algorithm: "codex-security/v1",
|
|
151
|
-
primary: fingerprint,
|
|
152
|
-
},
|
|
135
|
+
...deriveFindingIdentity(scanId, targetId, `import.${format}`, {
|
|
136
|
+
anchor: finding.occurrenceId,
|
|
137
|
+
}),
|
|
153
138
|
provenance: { source: `${format}_import` },
|
|
154
139
|
extensions: {
|
|
155
140
|
...finding.extensions,
|
|
@@ -192,9 +177,6 @@ export function parseFindingsCsv(source) {
|
|
|
192
177
|
new Set(headers).size !== headers.length) {
|
|
193
178
|
throw new CodexSecurityError(`Findings CSV must use the Codex Security export columns: ${REQUIRED_CSV_COLUMNS.join(", ")} (candidate_id is optional).`);
|
|
194
179
|
}
|
|
195
|
-
if (rows.length === 0) {
|
|
196
|
-
throw new CodexSecurityError("Findings CSV must contain at least one finding.");
|
|
197
|
-
}
|
|
198
180
|
const occurrenceIds = new Set();
|
|
199
181
|
return rows.map((record, index) => {
|
|
200
182
|
const rowNumber = index + 2;
|
|
@@ -213,13 +195,13 @@ export function parseFindingsCsv(source) {
|
|
|
213
195
|
function decodeExportedCsvCell(value) {
|
|
214
196
|
return EXPORTED_CSV_ESCAPE.test(value) ? value.slice(1) : value;
|
|
215
197
|
}
|
|
216
|
-
export function csvRowFinding(row
|
|
198
|
+
export function csvRowFinding(row) {
|
|
217
199
|
const ruleId = "import.csv";
|
|
218
200
|
const anchor = row.occurrence_id;
|
|
219
201
|
const fingerprint = `codex-security/v1:sha256:${sha256(["codex-security/v1", CSV_TARGET_ID, ruleId, anchor, ""].join("\0"))}`;
|
|
220
202
|
return {
|
|
221
|
-
findingId:
|
|
222
|
-
occurrenceId:
|
|
203
|
+
findingId: row.finding_id,
|
|
204
|
+
occurrenceId: row.occurrence_id,
|
|
223
205
|
ruleId,
|
|
224
206
|
identity: { anchor },
|
|
225
207
|
fingerprints: {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"findings-import.js","sourceRoot":"","sources":["../src/findings-import.ts"],"names":[],"mappings":"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","sourcesContent":["import { sha256Text as sha256 } from \"./contract.js\";\nimport { readFile } from \"node:fs/promises\";\nimport { isAbsolute, join, posix } from \"node:path\";\nimport Ajv2020 from \"ajv/dist/2020.js\";\nimport { z } from \"incur\";\nimport Papa from \"papaparse\";\nimport { CodexSecurityError } from \"./errors.js\";\nimport type { Finding, FindingsDocument } from \"./models.js\";\n\nexport const CSV_TARGET_ID = \"codex-security-csv-import\";\nexport type FindingsImportFormat = \"csv\" | \"json\";\n\n// Match the Python exporter's str.lstrip(), including its extra C0 separators.\nconst EXPORTED_CSV_ESCAPE =\n /^'(?:['\\t\\r\\n]|[\\p{White_Space}\\u001c-\\u001f]*[=+\\-@=+-@])/u;\nconst csvFindingRowSchema = z\n .object({\n occurrence_id: z.string().regex(/^occ_[a-f0-9]{24}$/u, {\n error: \"has an invalid occurrence_id\",\n }),\n finding_id: z.string().regex(/^csf_[a-f0-9]{24}$/u, {\n error: \"has an invalid finding_id\",\n }),\n candidate_id: z\n .string()\n .optional()\n .transform((value) =>\n value === undefined || value.trim() === \"\" ? undefined : value,\n ),\n title: requiredCsvText(\"title\"),\n summary: requiredCsvText(\"summary\"),\n severity: z.enum([\"critical\", \"high\", \"medium\", \"low\", \"informational\"], {\n error: \"has an invalid severity\",\n }),\n confidence: z.enum([\"high\", \"medium\", \"low\"], {\n error: \"has an invalid confidence\",\n }),\n status: z.enum([\"open\", \"closed\"], {\n error: \"has an invalid status\",\n }),\n close_reason: z\n .union(\n [\n z.literal(\"\"),\n z.enum([\"already_fixed\", \"wont_fix\", \"false_positive\"]),\n ],\n { error: \"has an invalid close_reason\" },\n )\n .transform((value) => (value === \"\" ? undefined : value)),\n note: z\n .string()\n .transform((value) => (value.trim() === \"\" ? undefined : value)),\n remediation: requiredCsvText(\"remediation\"),\n path: z.string().refine(safeFindingPath, {\n error: \"has an invalid path\",\n }),\n start_line: z\n .string()\n .refine(validCsvLine, { error: \"has an invalid start_line\" })\n .transform(Number),\n end_line: z\n .string()\n .refine((value) => value === \"\" || validCsvLine(value), {\n error: \"has an invalid end_line\",\n })\n .transform((value) => (value === \"\" ? undefined : Number(value))),\n })\n .superRefine((row, context) => {\n if (\n (row.status === \"open\" && row.close_reason !== undefined) ||\n (row.status === \"closed\" && row.close_reason === undefined)\n ) {\n context.addIssue({\n code: \"custom\",\n path: [\"close_reason\"],\n message: \"has an invalid close_reason\",\n });\n }\n if (\n row.status === \"closed\" &&\n (row.close_reason === \"false_positive\" ||\n row.close_reason === \"wont_fix\") &&\n row.note === undefined\n ) {\n context.addIssue({\n code: \"custom\",\n path: [\"note\"],\n message: \"requires a note for its close_reason\",\n });\n }\n if (row.end_line !== undefined && row.end_line < row.start_line) {\n context.addIssue({\n code: \"custom\",\n path: [\"end_line\"],\n message: \"has end_line before start_line\",\n });\n }\n });\ntype CsvFindingRow = z.infer<typeof csvFindingRowSchema>;\ntype CsvColumn = keyof typeof csvFindingRowSchema.shape;\nconst CSV_COLUMNS = Object.keys(csvFindingRowSchema.shape) as CsvColumn[];\nconst REQUIRED_CSV_COLUMNS = CSV_COLUMNS.filter(\n (column) => !csvFindingRowSchema.shape[column].isOptional(),\n);\n\nexport async function parseImportedFindings(\n source: string,\n format: FindingsImportFormat,\n pluginRoot: string,\n): Promise<Finding[]> {\n if (format === \"csv\") {\n return parseFindingsCsv(source).map((row) => ({\n ...csvRowFinding(row, \"import\"),\n findingId: row.finding_id,\n occurrenceId: row.occurrence_id,\n }));\n }\n\n let payload: unknown;\n try {\n // Exported findings files often start with a UTF-8 byte order mark, which\n // the CSV parser already skips.\n payload = JSON.parse(source.replace(/^\\uFEFF/u, \"\"));\n } catch (error) {\n throw new CodexSecurityError(\"Findings JSON could not be parsed.\", {\n cause: error,\n });\n }\n if (\n payload === null ||\n typeof payload !== \"object\" ||\n Array.isArray(payload)\n ) {\n throw new CodexSecurityError(\n \"Findings JSON must contain a findings document or an object with a findings array.\",\n );\n }\n const hasDocumentMetadata = [\"documentType\", \"schemaVersion\", \"scanId\"].some(\n (key) => Object.hasOwn(payload, key),\n );\n const document = hasDocumentMetadata\n ? payload\n : {\n documentType: \"codex-security.findings\",\n schemaVersion: \"1.0\",\n scanId: \"import\",\n ...payload,\n };\n const schema = JSON.parse(\n await readFile(join(pluginRoot, \"schemas\", \"findings.schema.json\"), \"utf8\"),\n );\n const validate = new Ajv2020({ strict: false }).compile<FindingsDocument>(\n schema,\n );\n if (!validate(document)) {\n const error = validate.errors?.[0];\n throw new CodexSecurityError(\n `Findings JSON does not match the Codex Security findings schema${error ? ` at ${error.instancePath || \"/\"}: ${error.message}` : \"\"}.`,\n );\n }\n const occurrenceIds = new Set<string>();\n for (const [index, finding] of document.findings.entries()) {\n if (occurrenceIds.has(finding.occurrenceId)) {\n throw new CodexSecurityError(\n `Findings JSON finding ${index + 1} has a duplicate occurrenceId.`,\n );\n }\n occurrenceIds.add(finding.occurrenceId);\n }\n return document.findings;\n}\n\nexport function bindImportedFindings(\n findings: Finding[],\n format: FindingsImportFormat,\n scanId: string,\n targetId: string,\n): Finding[] {\n return findings.map((finding) => {\n const ruleId = `import.${format}`;\n const anchor = finding.occurrenceId;\n const fingerprint = `codex-security/v1:sha256:${sha256(\n [\"codex-security/v1\", targetId, ruleId, anchor, \"\"].join(\"\\0\"),\n )}`;\n // A source report path names another scan's artifact. Preserve it as\n // provenance without treating the imported path as permission to read it.\n const { writeup, ...content } = finding;\n return {\n ...content,\n findingId: `csf_${sha256(fingerprint).slice(0, 24)}`,\n occurrenceId: `occ_${sha256([scanId, fingerprint].join(\"\\0\")).slice(0, 24)}`,\n ruleId,\n identity: { anchor },\n fingerprints: {\n algorithm: \"codex-security/v1\",\n primary: fingerprint,\n },\n provenance: { source: `${format}_import` },\n extensions: {\n ...finding.extensions,\n import: {\n format,\n sourceFindingId: finding.findingId,\n sourceOccurrenceId: finding.occurrenceId,\n sourceRuleId: finding.ruleId,\n sourceIdentity: finding.identity,\n sourceFingerprints: finding.fingerprints,\n sourceProvenance: finding.provenance,\n ...(writeup === undefined ? {} : { sourceWriteup: writeup }),\n ...(finding.extensions?.[\"import\"] === undefined\n ? {}\n : { previousImport: finding.extensions[\"import\"] }),\n },\n },\n };\n });\n}\n\nexport function parseFindingsCsv(source: string): CsvFindingRow[] {\n const {\n data: rows,\n errors,\n meta,\n } = Papa.parse<Record<string, string>>(source, {\n header: true,\n delimiter: \",\",\n skipEmptyLines: \"greedy\",\n transform: decodeExportedCsvCell,\n });\n const fieldMismatch = errors.find(\n (error) => error.code === \"TooFewFields\" || error.code === \"TooManyFields\",\n );\n if (fieldMismatch?.row !== undefined) {\n throw csvRowError(fieldMismatch.row + 2, \"must match the header columns\");\n }\n if (errors.length > 0) {\n throw new CodexSecurityError(\n `Findings CSV could not be parsed: ${errors[0]!.message}`,\n );\n }\n const headers = meta.fields;\n const allowed = new Set<string>(CSV_COLUMNS);\n if (\n headers === undefined ||\n !REQUIRED_CSV_COLUMNS.every((name) => headers.includes(name)) ||\n headers.some((name) => !allowed.has(name)) ||\n new Set(headers).size !== headers.length\n ) {\n throw new CodexSecurityError(\n `Findings CSV must use the Codex Security export columns: ${REQUIRED_CSV_COLUMNS.join(\", \")} (candidate_id is optional).`,\n );\n }\n if (rows.length === 0) {\n throw new CodexSecurityError(\n \"Findings CSV must contain at least one finding.\",\n );\n }\n\n const occurrenceIds = new Set<string>();\n return rows.map((record, index) => {\n const rowNumber = index + 2;\n const parsed = csvFindingRowSchema.safeParse(record);\n if (!parsed.success) {\n throw csvRowError(rowNumber, parsed.error.issues[0]!.message);\n }\n const row = parsed.data;\n if (occurrenceIds.has(row.occurrence_id)) {\n throw csvRowError(rowNumber, \"has a duplicate occurrence_id\");\n }\n occurrenceIds.add(row.occurrence_id);\n return row;\n });\n}\n\nfunction decodeExportedCsvCell(value: string): string {\n return EXPORTED_CSV_ESCAPE.test(value) ? value.slice(1) : value;\n}\n\nexport function csvRowFinding(row: CsvFindingRow, scanId: string): Finding {\n const ruleId = \"import.csv\";\n const anchor = row.occurrence_id;\n const fingerprint = `codex-security/v1:sha256:${sha256(\n [\"codex-security/v1\", CSV_TARGET_ID, ruleId, anchor, \"\"].join(\"\\0\"),\n )}`;\n return {\n findingId: `csf_${sha256(fingerprint).slice(0, 24)}`,\n occurrenceId: `occ_${sha256([scanId, fingerprint].join(\"\\0\")).slice(\n 0,\n 24,\n )}`,\n ruleId,\n identity: { anchor },\n fingerprints: {\n algorithm: \"codex-security/v1\",\n primary: fingerprint,\n },\n title: row.title,\n summary: row.summary,\n severity: { level: row.severity },\n confidence: {\n level: row.confidence,\n rationale: \"Imported from a Codex Security findings CSV.\",\n },\n taxonomy: { category: \"imported\", cwe: [] },\n locations: [\n {\n path: row.path,\n startLine: row.start_line,\n ...(row.end_line === undefined ? {} : { endLine: row.end_line }),\n },\n ],\n remediation: row.remediation,\n validation: {\n method: \"Source-reported CSV import metadata\",\n status: row.status,\n summary: [\n `Source finding ID: ${row.finding_id}`,\n `Source occurrence ID: ${row.occurrence_id}`,\n `Source status: ${row.status}`,\n ...(row.close_reason === undefined\n ? []\n : [`Source close reason: ${row.close_reason}`]),\n ...(row.note === undefined ? [] : [`Source note: ${row.note}`]),\n ].join(\"\\n\"),\n },\n provenance: { source: \"csv_import\" },\n extensions: {\n ...(row.candidate_id === undefined\n ? {}\n : { candidateId: row.candidate_id }),\n },\n };\n}\n\nfunction requiredCsvText(column: string) {\n return z.string().refine((value) => value.trim().length > 0, {\n error: `requires ${column}`,\n });\n}\n\nfunction validCsvLine(value: string): boolean {\n if (!/^[1-9]\\d*$/u.test(value)) return false;\n return Number.isSafeInteger(Number(value));\n}\n\nfunction safeFindingPath(value: string): boolean {\n if (\n value.trim().length === 0 ||\n value === \".\" ||\n isAbsolute(value) ||\n /^[A-Za-z]:/u.test(value) ||\n value.includes(\"\\\\\") ||\n /[\\u0000-\\u001F]/u.test(value) ||\n value.split(\"/\").includes(\"..\")\n ) {\n return false;\n }\n const normalized = posix.normalize(value).replace(/\\/+$/u, \"\");\n return normalized !== \".\" && !normalized.startsWith(\"../\");\n}\n\nfunction csvRowError(rowNumber: number, detail: string): CodexSecurityError {\n return new CodexSecurityError(`Findings CSV row ${rowNumber} ${detail}.`);\n}\n"]}
|
|
1
|
+
{"version":3,"file":"findings-import.js","sourceRoot":"","sources":["../src/findings-import.ts"],"names":[],"mappings":"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","sourcesContent":["import { isRecord } from \"./record.js\";\nimport { deriveFindingIdentity, sha256Text as sha256 } from \"./contract.js\";\nimport { readFile } from \"node:fs/promises\";\nimport { isAbsolute, join, posix } from \"node:path\";\nimport Ajv2020 from \"ajv/dist/2020.js\";\nimport { z } from \"incur\";\nimport Papa from \"papaparse\";\nimport { CodexSecurityError, errorMessage } from \"./errors.js\";\nimport type { Finding, FindingsDocument } from \"./models.js\";\n\nexport const CSV_TARGET_ID = \"codex-security-csv-import\";\nexport type FindingsImportFormat = \"csv\" | \"json\";\n\n// Match the Python exporter's str.lstrip(), including its extra C0 separators.\nconst EXPORTED_CSV_ESCAPE =\n /^'(?:['\\t\\r\\n]|[\\p{White_Space}\\u001c-\\u001f]*[=+\\-@=+-@])/u;\nconst csvFindingRowSchema = z\n .object({\n occurrence_id: z.string().regex(/^occ_[a-f0-9]{24}$/u, {\n error: \"has an invalid occurrence_id\",\n }),\n finding_id: z.string().regex(/^csf_[a-f0-9]{24}$/u, {\n error: \"has an invalid finding_id\",\n }),\n candidate_id: z\n .string()\n .optional()\n .transform((value) =>\n value === undefined || value.trim() === \"\" ? undefined : value,\n ),\n title: requiredCsvText(\"title\"),\n summary: requiredCsvText(\"summary\"),\n severity: z.enum([\"critical\", \"high\", \"medium\", \"low\", \"informational\"], {\n error: \"has an invalid severity\",\n }),\n confidence: z.enum([\"high\", \"medium\", \"low\"], {\n error: \"has an invalid confidence\",\n }),\n status: z.enum([\"open\", \"closed\"], {\n error: \"has an invalid status\",\n }),\n close_reason: z\n .union(\n [\n z.literal(\"\"),\n z.enum([\"already_fixed\", \"wont_fix\", \"false_positive\"]),\n ],\n { error: \"has an invalid close_reason\" },\n )\n .transform((value) => (value === \"\" ? undefined : value)),\n note: z\n .string()\n .transform((value) => (value.trim() === \"\" ? undefined : value)),\n remediation: requiredCsvText(\"remediation\"),\n path: z.string().refine(safeFindingPath, {\n error: \"has an invalid path\",\n }),\n start_line: z\n .string()\n .refine(validCsvLine, { error: \"has an invalid start_line\" })\n .transform(Number),\n end_line: z\n .string()\n .refine((value) => value === \"\" || validCsvLine(value), {\n error: \"has an invalid end_line\",\n })\n .transform((value) => (value === \"\" ? undefined : Number(value))),\n })\n .superRefine((row, context) => {\n if (\n (row.status === \"open\" && row.close_reason !== undefined) ||\n (row.status === \"closed\" && row.close_reason === undefined)\n ) {\n context.addIssue({\n code: \"custom\",\n path: [\"close_reason\"],\n message: \"has an invalid close_reason\",\n });\n }\n if (\n row.status === \"closed\" &&\n (row.close_reason === \"false_positive\" ||\n row.close_reason === \"wont_fix\") &&\n row.note === undefined\n ) {\n context.addIssue({\n code: \"custom\",\n path: [\"note\"],\n message: \"requires a note for its close_reason\",\n });\n }\n if (row.end_line !== undefined && row.end_line < row.start_line) {\n context.addIssue({\n code: \"custom\",\n path: [\"end_line\"],\n message: \"has end_line before start_line\",\n });\n }\n });\ntype CsvFindingRow = z.infer<typeof csvFindingRowSchema>;\ntype CsvColumn = keyof typeof csvFindingRowSchema.shape;\nconst CSV_COLUMNS = Object.keys(csvFindingRowSchema.shape) as CsvColumn[];\nconst REQUIRED_CSV_COLUMNS = CSV_COLUMNS.filter(\n (column) => !csvFindingRowSchema.shape[column].isOptional(),\n);\n\nexport async function parseImportedFindings(\n source: string,\n format: FindingsImportFormat,\n pluginRoot: string,\n): Promise<Finding[]> {\n if (format === \"csv\") {\n return parseFindingsCsv(source).map(csvRowFinding);\n }\n\n let payload: unknown;\n try {\n // Exported findings files often start with a UTF-8 byte order mark, which\n // the CSV parser already skips.\n payload = JSON.parse(source.replace(/^\\uFEFF/u, \"\"));\n } catch (error) {\n throw new CodexSecurityError(\n `Findings JSON could not be parsed. ${errorMessage(error)}`,\n { cause: error },\n );\n }\n if (!isRecord(payload)) {\n throw new CodexSecurityError(\n \"Findings JSON must contain a findings document or an object with a findings array.\",\n );\n }\n const hasDocumentMetadata = [\"documentType\", \"schemaVersion\", \"scanId\"].some(\n (key) => Object.hasOwn(payload, key),\n );\n const document = hasDocumentMetadata\n ? payload\n : {\n documentType: \"codex-security.findings\",\n schemaVersion: \"1.0\",\n scanId: \"import\",\n ...payload,\n };\n const schema = JSON.parse(\n await readFile(join(pluginRoot, \"schemas\", \"findings.schema.json\"), \"utf8\"),\n );\n const validate = new Ajv2020({ strict: false }).compile<FindingsDocument>(\n schema,\n );\n if (!validate(document)) {\n const error = validate.errors?.[0];\n throw new CodexSecurityError(\n `Findings JSON does not match the Codex Security findings schema${error ? ` at ${error.instancePath || \"/\"}: ${error.message}` : \"\"}.`,\n );\n }\n const occurrenceIds = new Set<string>();\n for (const [index, finding] of document.findings.entries()) {\n if (occurrenceIds.has(finding.occurrenceId)) {\n throw new CodexSecurityError(\n `Findings JSON finding ${index + 1} has a duplicate occurrenceId.`,\n );\n }\n occurrenceIds.add(finding.occurrenceId);\n }\n return document.findings;\n}\n\nexport function bindImportedFindings(\n findings: Finding[],\n format: FindingsImportFormat,\n scanId: string,\n targetId: string,\n): Finding[] {\n return findings.map((finding) => {\n // A source report path names another scan's artifact. Preserve it as\n // provenance without treating the imported path as permission to read it.\n const { writeup, ...content } = finding;\n return {\n ...content,\n ...deriveFindingIdentity(scanId, targetId, `import.${format}`, {\n anchor: finding.occurrenceId,\n }),\n provenance: { source: `${format}_import` },\n extensions: {\n ...finding.extensions,\n import: {\n format,\n sourceFindingId: finding.findingId,\n sourceOccurrenceId: finding.occurrenceId,\n sourceRuleId: finding.ruleId,\n sourceIdentity: finding.identity,\n sourceFingerprints: finding.fingerprints,\n sourceProvenance: finding.provenance,\n ...(writeup === undefined ? {} : { sourceWriteup: writeup }),\n ...(finding.extensions?.[\"import\"] === undefined\n ? {}\n : { previousImport: finding.extensions[\"import\"] }),\n },\n },\n };\n });\n}\n\nexport function parseFindingsCsv(source: string): CsvFindingRow[] {\n const {\n data: rows,\n errors,\n meta,\n } = Papa.parse<Record<string, string>>(source, {\n header: true,\n delimiter: \",\",\n skipEmptyLines: \"greedy\",\n transform: decodeExportedCsvCell,\n });\n const fieldMismatch = errors.find(\n (error) => error.code === \"TooFewFields\" || error.code === \"TooManyFields\",\n );\n if (fieldMismatch?.row !== undefined) {\n throw csvRowError(fieldMismatch.row + 2, \"must match the header columns\");\n }\n if (errors.length > 0) {\n throw new CodexSecurityError(\n `Findings CSV could not be parsed: ${errors[0]!.message}`,\n );\n }\n const headers = meta.fields;\n const allowed = new Set<string>(CSV_COLUMNS);\n if (\n headers === undefined ||\n !REQUIRED_CSV_COLUMNS.every((name) => headers.includes(name)) ||\n headers.some((name) => !allowed.has(name)) ||\n new Set(headers).size !== headers.length\n ) {\n throw new CodexSecurityError(\n `Findings CSV must use the Codex Security export columns: ${REQUIRED_CSV_COLUMNS.join(\", \")} (candidate_id is optional).`,\n );\n }\n\n const occurrenceIds = new Set<string>();\n return rows.map((record, index) => {\n const rowNumber = index + 2;\n const parsed = csvFindingRowSchema.safeParse(record);\n if (!parsed.success) {\n throw csvRowError(rowNumber, parsed.error.issues[0]!.message);\n }\n const row = parsed.data;\n if (occurrenceIds.has(row.occurrence_id)) {\n throw csvRowError(rowNumber, \"has a duplicate occurrence_id\");\n }\n occurrenceIds.add(row.occurrence_id);\n return row;\n });\n}\n\nfunction decodeExportedCsvCell(value: string): string {\n return EXPORTED_CSV_ESCAPE.test(value) ? value.slice(1) : value;\n}\n\nexport function csvRowFinding(row: CsvFindingRow): Finding {\n const ruleId = \"import.csv\";\n const anchor = row.occurrence_id;\n const fingerprint = `codex-security/v1:sha256:${sha256(\n [\"codex-security/v1\", CSV_TARGET_ID, ruleId, anchor, \"\"].join(\"\\0\"),\n )}`;\n return {\n findingId: row.finding_id,\n occurrenceId: row.occurrence_id,\n ruleId,\n identity: { anchor },\n fingerprints: {\n algorithm: \"codex-security/v1\",\n primary: fingerprint,\n },\n title: row.title,\n summary: row.summary,\n severity: { level: row.severity },\n confidence: {\n level: row.confidence,\n rationale: \"Imported from a Codex Security findings CSV.\",\n },\n taxonomy: { category: \"imported\", cwe: [] },\n locations: [\n {\n path: row.path,\n startLine: row.start_line,\n ...(row.end_line === undefined ? {} : { endLine: row.end_line }),\n },\n ],\n remediation: row.remediation,\n validation: {\n method: \"Source-reported CSV import metadata\",\n status: row.status,\n summary: [\n `Source finding ID: ${row.finding_id}`,\n `Source occurrence ID: ${row.occurrence_id}`,\n `Source status: ${row.status}`,\n ...(row.close_reason === undefined\n ? []\n : [`Source close reason: ${row.close_reason}`]),\n ...(row.note === undefined ? [] : [`Source note: ${row.note}`]),\n ].join(\"\\n\"),\n },\n provenance: { source: \"csv_import\" },\n extensions: {\n ...(row.candidate_id === undefined\n ? {}\n : { candidateId: row.candidate_id }),\n },\n };\n}\n\nfunction requiredCsvText(column: string) {\n return z.string().refine((value) => value.trim().length > 0, {\n error: `requires ${column}`,\n });\n}\n\nfunction validCsvLine(value: string): boolean {\n if (!/^[1-9]\\d*$/u.test(value)) return false;\n return Number.isSafeInteger(Number(value));\n}\n\nfunction safeFindingPath(value: string): boolean {\n if (\n value.trim().length === 0 ||\n value === \".\" ||\n isAbsolute(value) ||\n /^[A-Za-z]:/u.test(value) ||\n value.includes(\"\\\\\") ||\n /[\\u0000-\\u001F]/u.test(value) ||\n value.split(\"/\").includes(\"..\")\n ) {\n return false;\n }\n const normalized = posix.normalize(value).replace(/\\/+$/u, \"\");\n return normalized !== \".\" && !normalized.startsWith(\"../\");\n}\n\nfunction csvRowError(rowNumber: number, detail: string): CodexSecurityError {\n return new CodexSecurityError(`Findings CSV row ${rowNumber} ${detail}.`);\n}\n"]}
|
package/dist/github.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../src/github.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAKxC,KAAK,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC;AAEhE,eAAO,MAAM,mBAAmB,YAC9B,MAAM,EACN,QAAQ,EACR,WAAW,EACX,OAAO,EACP,KAAK,CACG,CAAC;AAEX,MAAM,WAAW,+BAA+B;IAC9C,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,sDAAsD;IACtD,KAAK,CAAC,EAAE,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;IAC7C,kEAAkE;IAClE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,+BAA+B;IAC9C,MAAM,EAAE,sBAAsB,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,2EAA2E;IAC3E,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,UAAU,wBAAwB;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACzE;AAED,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IACP,WAAW,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;CACjB,GACL,OAAO,CAAC,OAAO,CAAC,
|
|
1
|
+
{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../src/github.ts"],"names":[],"mappings":"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"}
|
package/dist/github.js
CHANGED
|
@@ -33,7 +33,13 @@ export async function createAuthenticatedGitHub(host, options = {}) {
|
|
|
33
33
|
}
|
|
34
34
|
return new Octokit({
|
|
35
35
|
auth: token,
|
|
36
|
-
...(host === "github.com"
|
|
36
|
+
...(host === "github.com"
|
|
37
|
+
? {}
|
|
38
|
+
: {
|
|
39
|
+
baseUrl: host.toLowerCase().endsWith(".ghe.com")
|
|
40
|
+
? `https://api.${host}`
|
|
41
|
+
: `https://${host}/api/v3`,
|
|
42
|
+
}),
|
|
37
43
|
});
|
|
38
44
|
}
|
|
39
45
|
export async function importGitHubCodeScanningAlerts(options, dependencies = {}) {
|
package/dist/github.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"github.js","sourceRoot":"","sources":["../src/github.ts"],"names":[],"mappings":"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","sourcesContent":["import { execFile as execFileCallback } from \"node:child_process\";\nimport { promisify } from \"node:util\";\nimport { Octokit } from \"@octokit/core\";\nimport { CodexSecurityError, errorMessage } from \"./errors.js\";\nimport { resolveTrustedExecutable } from \"./trusted-executable.js\";\n\nconst execFile = promisify(execFileCallback);\ntype GitHubAlert = Awaited<ReturnType<typeof fetchGitHubAlert>>;\n\nexport const GITHUB_ALERT_STATES = [\n \"open\",\n \"closed\",\n \"dismissed\",\n \"fixed\",\n \"all\",\n] as const;\n\nexport interface GitHubCodeScanningImportOptions {\n /** GitHub repository in OWNER/REPO form. */\n repository: string;\n /** Exact alert numbers, regardless of state. Omit to list matching alerts. */\n alertNumbers?: readonly number[];\n /** State used when listing alerts (default: open). */\n state?: (typeof GITHUB_ALERT_STATES)[number];\n /** Git reference to inspect; omitted lists the default branch. */\n ref?: string;\n /** Defaults to GH_HOST or github.com. */\n githubHost?: string;\n /** Omit to use the authenticated GitHub CLI, including its token environment. */\n githubToken?: string;\n signal?: AbortSignal;\n}\n\nexport interface ImportedGitHubCodeScanningAlert {\n source: \"github-code-scanning\";\n repository: string;\n number: number;\n url: string;\n /** Upstream evidence, not a validated or sealed Codex Security finding. */\n alert: GitHubAlert;\n}\n\ninterface GitHubImportDependencies {\n environment?: NodeJS.ProcessEnv;\n currentDirectory?: string;\n createGitHub?: (host: string, signal?: AbortSignal) => Promise<Octokit>;\n}\n\nexport async function createAuthenticatedGitHub(\n host: string,\n options: {\n environment?: NodeJS.ProcessEnv;\n currentDirectory?: string;\n token?: string;\n signal?: AbortSignal;\n } = {},\n): Promise<Octokit> {\n options.signal?.throwIfAborted();\n let token = options.token;\n if (token === undefined) {\n const trusted = await resolveTrustedExecutable(\n \"gh\",\n options.environment ?? process.env,\n options.currentDirectory ?? process.cwd(),\n );\n if (trusted === null) {\n throw new CodexSecurityError(\n \"GitHub CLI is required. Install gh and sign in first.\",\n );\n }\n try {\n const { stdout } = await execFile(\n trusted.executable,\n [\"auth\", \"token\", \"--hostname\", host],\n { env: trusted.environment, signal: options.signal },\n );\n token = stdout.trim();\n } catch {\n options.signal?.throwIfAborted();\n throw new CodexSecurityError(\n \"GitHub sign-in is required. Run 'gh auth login' first.\",\n );\n }\n }\n if (token.trim().length === 0) {\n throw new CodexSecurityError(\"GitHub access token must not be empty.\");\n }\n return new Octokit({\n auth: token,\n ...(host === \"github.com\" ? {} : { baseUrl: `https://${host}/api/v3` }),\n });\n}\n\nexport async function importGitHubCodeScanningAlerts(\n options: GitHubCodeScanningImportOptions,\n dependencies: GitHubImportDependencies = {},\n): Promise<ImportedGitHubCodeScanningAlert[]> {\n options.signal?.throwIfAborted();\n const repository = options.repository.trim();\n const parts = /^([a-z0-9_.-]+)\\/([a-z0-9_.-]+)$/iu.exec(repository);\n if (\n parts === null ||\n parts.slice(1).some((part) => /^\\.{1,2}$/u.test(part))\n ) {\n throw new CodexSecurityError(\"GitHub repository must be OWNER/REPO.\");\n }\n const owner = parts[1]!;\n const repo = parts[2]!;\n const numbers = [...new Set(options.alertNumbers ?? [])];\n if (numbers.some((number) => !Number.isSafeInteger(number) || number < 1)) {\n throw new CodexSecurityError(\n \"GitHub alert numbers must be positive integers.\",\n );\n }\n const state = options.state ?? \"open\";\n if (!GITHUB_ALERT_STATES.includes(state)) {\n throw new CodexSecurityError(\"GitHub alert state is invalid.\");\n }\n if (numbers.length > 0 && state !== \"open\") {\n throw new CodexSecurityError(\n \"--github-state only filters lists; use it without --github-alert.\",\n );\n }\n const ref = options.ref?.trim();\n if (ref === \"\") {\n throw new CodexSecurityError(\"GitHub reference must not be empty.\");\n }\n const environment = dependencies.environment ?? process.env;\n const host =\n options.githubHost?.trim() ??\n (environment[\"GH_HOST\"]?.trim() || \"github.com\");\n if (host.length === 0) {\n throw new CodexSecurityError(\"GitHub host must not be empty.\");\n }\n\n try {\n const github = dependencies.createGitHub\n ? await dependencies.createGitHub(host, options.signal)\n : await createAuthenticatedGitHub(host, {\n token: options.githubToken,\n environment,\n currentDirectory: dependencies.currentDirectory,\n signal: options.signal,\n });\n const selected = new Map<number, GitHubAlert[\"most_recent_instance\"]>();\n if (numbers.length === 0 || ref !== undefined) {\n let page = 1;\n while (true) {\n options.signal?.throwIfAborted();\n // Octokit's list route omits GitHub's \"closed\" state.\n const response = await github.request<\n Pick<GitHubAlert, \"number\" | \"most_recent_instance\">[]\n >({\n method: \"GET\",\n url: \"/repos/{owner}/{repo}/code-scanning/alerts\",\n owner,\n repo,\n per_page: 100,\n page,\n ref,\n state: numbers.length > 0 || state === \"all\" ? undefined : state,\n request: { signal: options.signal, redirect: \"error\" },\n });\n for (const alert of response.data) {\n if (numbers.length === 0 || numbers.includes(alert.number)) {\n selected.set(alert.number, alert.most_recent_instance);\n }\n }\n if (\n !response.headers.link?.includes('rel=\"next\"') ||\n (numbers.length > 0 && selected.size === numbers.length)\n )\n break;\n page += 1;\n }\n if (numbers.some((number) => !selected.has(number))) {\n throw new CodexSecurityError(\n \"One or more selected GitHub alerts were not found on the requested reference.\",\n );\n }\n }\n const alerts: ImportedGitHubCodeScanningAlert[] = [];\n for (const number of numbers.length > 0 ? numbers : selected.keys()) {\n options.signal?.throwIfAborted();\n const alert = await fetchGitHubAlert(\n github,\n owner,\n repo,\n number,\n options.signal,\n );\n // Detail requests use the default branch; retain the listed ref's evidence.\n const instance = selected.get(number);\n alerts.push({\n source: \"github-code-scanning\",\n repository,\n number,\n url: alert.html_url,\n alert:\n instance === undefined\n ? alert\n : { ...alert, most_recent_instance: instance },\n });\n }\n return alerts;\n } catch (error) {\n options.signal?.throwIfAborted();\n if (error instanceof CodexSecurityError) throw error;\n const status =\n typeof error === \"object\" && error !== null && \"status\" in error\n ? error.status\n : undefined;\n if (status === 401)\n throw new CodexSecurityError(\"GitHub authentication failed.\");\n if (status === 403) {\n throw new CodexSecurityError(\n \"GitHub denied code scanning access. Check repository permissions, code scanning availability, and API rate limits.\",\n );\n }\n if (status === 404) {\n throw new CodexSecurityError(\n \"GitHub repository or code scanning alert was not found or is not accessible.\",\n );\n }\n if (status === 429)\n throw new CodexSecurityError(\n \"GitHub request was rate limited. Wait and retry.\",\n );\n throw new CodexSecurityError(\n `GitHub code scanning request failed${typeof status === \"number\" ? ` (HTTP ${status})` : \"\"}: ${errorMessage(error)}`,\n );\n }\n}\n\nasync function fetchGitHubAlert(\n github: Octokit,\n owner: string,\n repo: string,\n alertNumber: number,\n signal?: AbortSignal,\n) {\n const response = await github.request(\n \"GET /repos/{owner}/{repo}/code-scanning/alerts/{alert_number}\",\n {\n owner,\n repo,\n alert_number: alertNumber,\n request: { signal, redirect: \"error\" },\n },\n );\n return response.data;\n}\n"]}
|
|
1
|
+
{"version":3,"file":"github.js","sourceRoot":"","sources":["../src/github.ts"],"names":[],"mappings":"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","sourcesContent":["import { execFile as execFileCallback } from \"node:child_process\";\nimport { promisify } from \"node:util\";\nimport { Octokit } from \"@octokit/core\";\nimport { CodexSecurityError, errorMessage } from \"./errors.js\";\nimport { resolveTrustedExecutable } from \"./trusted-executable.js\";\n\nconst execFile = promisify(execFileCallback);\ntype GitHubAlert = Awaited<ReturnType<typeof fetchGitHubAlert>>;\n\nexport const GITHUB_ALERT_STATES = [\n \"open\",\n \"closed\",\n \"dismissed\",\n \"fixed\",\n \"all\",\n] as const;\n\nexport interface GitHubCodeScanningImportOptions {\n /** GitHub repository in OWNER/REPO form. */\n repository: string;\n /** Exact alert numbers, regardless of state. Omit to list matching alerts. */\n alertNumbers?: readonly number[];\n /** State used when listing alerts (default: open). */\n state?: (typeof GITHUB_ALERT_STATES)[number];\n /** Git reference to inspect; omitted lists the default branch. */\n ref?: string;\n /** Defaults to GH_HOST or github.com. */\n githubHost?: string;\n /** Omit to use the authenticated GitHub CLI, including its token environment. */\n githubToken?: string;\n signal?: AbortSignal;\n}\n\nexport interface ImportedGitHubCodeScanningAlert {\n source: \"github-code-scanning\";\n repository: string;\n number: number;\n url: string;\n /** Upstream evidence, not a validated or sealed Codex Security finding. */\n alert: GitHubAlert;\n}\n\ninterface GitHubImportDependencies {\n environment?: NodeJS.ProcessEnv;\n currentDirectory?: string;\n createGitHub?: (host: string, signal?: AbortSignal) => Promise<Octokit>;\n}\n\nexport async function createAuthenticatedGitHub(\n host: string,\n options: {\n environment?: NodeJS.ProcessEnv;\n currentDirectory?: string;\n token?: string;\n signal?: AbortSignal;\n } = {},\n): Promise<Octokit> {\n options.signal?.throwIfAborted();\n let token = options.token;\n if (token === undefined) {\n const trusted = await resolveTrustedExecutable(\n \"gh\",\n options.environment ?? process.env,\n options.currentDirectory ?? process.cwd(),\n );\n if (trusted === null) {\n throw new CodexSecurityError(\n \"GitHub CLI is required. Install gh and sign in first.\",\n );\n }\n try {\n const { stdout } = await execFile(\n trusted.executable,\n [\"auth\", \"token\", \"--hostname\", host],\n { env: trusted.environment, signal: options.signal },\n );\n token = stdout.trim();\n } catch {\n options.signal?.throwIfAborted();\n throw new CodexSecurityError(\n \"GitHub sign-in is required. Run 'gh auth login' first.\",\n );\n }\n }\n if (token.trim().length === 0) {\n throw new CodexSecurityError(\"GitHub access token must not be empty.\");\n }\n return new Octokit({\n auth: token,\n ...(host === \"github.com\"\n ? {}\n : {\n baseUrl: host.toLowerCase().endsWith(\".ghe.com\")\n ? `https://api.${host}`\n : `https://${host}/api/v3`,\n }),\n });\n}\n\nexport async function importGitHubCodeScanningAlerts(\n options: GitHubCodeScanningImportOptions,\n dependencies: GitHubImportDependencies = {},\n): Promise<ImportedGitHubCodeScanningAlert[]> {\n options.signal?.throwIfAborted();\n const repository = options.repository.trim();\n const parts = /^([a-z0-9_.-]+)\\/([a-z0-9_.-]+)$/iu.exec(repository);\n if (\n parts === null ||\n parts.slice(1).some((part) => /^\\.{1,2}$/u.test(part))\n ) {\n throw new CodexSecurityError(\"GitHub repository must be OWNER/REPO.\");\n }\n const owner = parts[1]!;\n const repo = parts[2]!;\n const numbers = [...new Set(options.alertNumbers ?? [])];\n if (numbers.some((number) => !Number.isSafeInteger(number) || number < 1)) {\n throw new CodexSecurityError(\n \"GitHub alert numbers must be positive integers.\",\n );\n }\n const state = options.state ?? \"open\";\n if (!GITHUB_ALERT_STATES.includes(state)) {\n throw new CodexSecurityError(\"GitHub alert state is invalid.\");\n }\n if (numbers.length > 0 && state !== \"open\") {\n throw new CodexSecurityError(\n \"--github-state only filters lists; use it without --github-alert.\",\n );\n }\n const ref = options.ref?.trim();\n if (ref === \"\") {\n throw new CodexSecurityError(\"GitHub reference must not be empty.\");\n }\n const environment = dependencies.environment ?? process.env;\n const host =\n options.githubHost?.trim() ??\n (environment[\"GH_HOST\"]?.trim() || \"github.com\");\n if (host.length === 0) {\n throw new CodexSecurityError(\"GitHub host must not be empty.\");\n }\n\n try {\n const github = dependencies.createGitHub\n ? await dependencies.createGitHub(host, options.signal)\n : await createAuthenticatedGitHub(host, {\n token: options.githubToken,\n environment,\n currentDirectory: dependencies.currentDirectory,\n signal: options.signal,\n });\n const selected = new Map<number, GitHubAlert[\"most_recent_instance\"]>();\n if (numbers.length === 0 || ref !== undefined) {\n let page = 1;\n while (true) {\n options.signal?.throwIfAborted();\n // Octokit's list route omits GitHub's \"closed\" state.\n const response = await github.request<\n Pick<GitHubAlert, \"number\" | \"most_recent_instance\">[]\n >({\n method: \"GET\",\n url: \"/repos/{owner}/{repo}/code-scanning/alerts\",\n owner,\n repo,\n per_page: 100,\n page,\n ref,\n state: numbers.length > 0 || state === \"all\" ? undefined : state,\n request: { signal: options.signal, redirect: \"error\" },\n });\n for (const alert of response.data) {\n if (numbers.length === 0 || numbers.includes(alert.number)) {\n selected.set(alert.number, alert.most_recent_instance);\n }\n }\n if (\n !response.headers.link?.includes('rel=\"next\"') ||\n (numbers.length > 0 && selected.size === numbers.length)\n )\n break;\n page += 1;\n }\n if (numbers.some((number) => !selected.has(number))) {\n throw new CodexSecurityError(\n \"One or more selected GitHub alerts were not found on the requested reference.\",\n );\n }\n }\n const alerts: ImportedGitHubCodeScanningAlert[] = [];\n for (const number of numbers.length > 0 ? numbers : selected.keys()) {\n options.signal?.throwIfAborted();\n const alert = await fetchGitHubAlert(\n github,\n owner,\n repo,\n number,\n options.signal,\n );\n // Detail requests use the default branch; retain the listed ref's evidence.\n const instance = selected.get(number);\n alerts.push({\n source: \"github-code-scanning\",\n repository,\n number,\n url: alert.html_url,\n alert:\n instance === undefined\n ? alert\n : { ...alert, most_recent_instance: instance },\n });\n }\n return alerts;\n } catch (error) {\n options.signal?.throwIfAborted();\n if (error instanceof CodexSecurityError) throw error;\n const status =\n typeof error === \"object\" && error !== null && \"status\" in error\n ? error.status\n : undefined;\n if (status === 401)\n throw new CodexSecurityError(\"GitHub authentication failed.\");\n if (status === 403) {\n throw new CodexSecurityError(\n \"GitHub denied code scanning access. Check repository permissions, code scanning availability, and API rate limits.\",\n );\n }\n if (status === 404) {\n throw new CodexSecurityError(\n \"GitHub repository or code scanning alert was not found or is not accessible.\",\n );\n }\n if (status === 429)\n throw new CodexSecurityError(\n \"GitHub request was rate limited. Wait and retry.\",\n );\n throw new CodexSecurityError(\n `GitHub code scanning request failed${typeof status === \"number\" ? ` (HTTP ${status})` : \"\"}: ${errorMessage(error)}`,\n );\n }\n}\n\nasync function fetchGitHubAlert(\n github: Octokit,\n owner: string,\n repo: string,\n alertNumber: number,\n signal?: AbortSignal,\n) {\n const response = await github.request(\n \"GET /repos/{owner}/{repo}/code-scanning/alerts/{alert_number}\",\n {\n owner,\n repo,\n alert_number: alertNumber,\n request: { signal, redirect: \"error\" },\n },\n );\n return response.data;\n}\n"]}
|