@openai/codex-security 0.2.0 → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +437 -2692
- package/_bundled_plugin/.app.json +5 -1
- package/_bundled_plugin/.codex-plugin/plugin.json +9 -5
- package/_bundled_plugin/.mcp.json +2 -0
- package/_bundled_plugin/examples/completed-scan/coverage.json +0 -1
- package/_bundled_plugin/examples/completed-scan/report.md +28 -26
- package/_bundled_plugin/examples/completed-scan/scan-manifest.json +1 -1
- package/_bundled_plugin/mcp/helpers.mjs +1 -0
- package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
- package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +6 -213
- package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
- package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
- package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
- package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
- package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
- package/_bundled_plugin/mcp/native/linux-x64-musl/unix.node +0 -0
- package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
- package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
- package/_bundled_plugin/mcp/permission-profile-preflight.mjs +563 -0
- package/_bundled_plugin/mcp/server.mjs +1 -0
- package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
- package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
- package/_bundled_plugin/preflight/capability-profiles.toml +0 -13
- package/_bundled_plugin/references/artifact-storage.md +2 -2
- package/_bundled_plugin/references/config-preflight.md +0 -4
- package/_bundled_plugin/references/core-scan.md +21 -9
- package/_bundled_plugin/references/final-report.md +10 -12
- package/_bundled_plugin/references/finding-detail-fields.md +90 -80
- package/_bundled_plugin/references/sarif-adapter.md +1 -1
- package/_bundled_plugin/references/scan-artifacts.md +1 -2
- package/_bundled_plugin/references/scan-contract.md +9 -4
- package/_bundled_plugin/references/scan-prologue.md +12 -0
- package/_bundled_plugin/references/security-guidance.md +2 -2
- package/_bundled_plugin/references/standalone-validation.md +11 -0
- package/_bundled_plugin/references/threat-model.md +1 -1
- package/_bundled_plugin/schemas/coverage.schema.json +1 -47
- package/_bundled_plugin/schemas/definitions/artifact-common.schema.json +2 -24
- package/_bundled_plugin/schemas/definitions/discovery-candidate.schema.json +49 -25
- package/_bundled_plugin/schemas/findings.schema.json +71 -192
- package/_bundled_plugin/schemas/scan-manifest.schema.json +18 -45
- package/_bundled_plugin/schemas/tools/candidate-attack-paths.schema.json +91 -83
- package/_bundled_plugin/schemas/tools/candidate-validations.schema.json +35 -64
- package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +5 -2
- package/_bundled_plugin/schemas/tools/discovery-candidates.schema.json +6 -55
- package/_bundled_plugin/schemas/tools/review-items.schema.json +2 -38
- package/_bundled_plugin/schemas/tools/scan-draft.schema.json +169 -294
- package/_bundled_plugin/scripts/codex_profile.mjs +239 -0
- package/_bundled_plugin/scripts/codex_session.mjs +53 -0
- package/_bundled_plugin/scripts/config_preflight.py +26 -62
- package/_bundled_plugin/scripts/deep_scan_config.py +9 -11
- package/_bundled_plugin/scripts/deep_scan_workbench.py +129 -150
- package/_bundled_plugin/scripts/finalize_scan_contract.py +315 -232
- package/_bundled_plugin/scripts/finding_preview.py +39 -9
- package/_bundled_plugin/scripts/generate_in_scope_files.py +27 -77
- package/_bundled_plugin/scripts/generate_rank_input.py +99 -829
- package/_bundled_plugin/scripts/launch_codex_security_mcp +35 -10
- package/_bundled_plugin/scripts/launch_codex_security_mcp.cmd +5 -5
- package/_bundled_plugin/scripts/rank_preview.py +42 -918
- package/_bundled_plugin/scripts/report_projection.py +117 -172
- package/_bundled_plugin/scripts/snapshot_sqlite.py +6 -1
- package/_bundled_plugin/scripts/threat_model_projection.py +4 -7
- package/_bundled_plugin/scripts/validate_scan_contract.py +4 -34
- package/_bundled_plugin/scripts/validate_tracking_source.py +3 -13
- package/_bundled_plugin/scripts/windows_scan_local_files.py +48 -3
- package/_bundled_plugin/scripts/workbench/handoff.py +25 -50
- package/_bundled_plugin/scripts/workbench/runtime_toml.py +22 -0
- package/_bundled_plugin/scripts/workbench/storage.py +10 -6
- package/_bundled_plugin/scripts/workbench_cli.py +94 -179
- package/_bundled_plugin/scripts/workbench_db.py +427 -463
- package/_bundled_plugin/scripts/workbench_feedback.py +6 -3
- package/_bundled_plugin/scripts/workbench_finding_index.py +19 -1
- package/_bundled_plugin/scripts/workbench_finding_workflows.py +18 -4
- package/_bundled_plugin/scripts/workbench_local_dedupe.py +136 -0
- package/_bundled_plugin/scripts/workbench_native_indexes.py +27 -14
- package/_bundled_plugin/scripts/workbench_progress.py +14 -58
- package/_bundled_plugin/scripts/workbench_publication.py +33 -57
- package/_bundled_plugin/scripts/workbench_remediation.py +12 -0
- package/_bundled_plugin/scripts/workbench_saved_results.py +172 -49
- package/_bundled_plugin/scripts/workbench_scan_history.py +57 -57
- package/_bundled_plugin/scripts/workbench_scan_start.py +105 -41
- package/_bundled_plugin/scripts/workbench_scan_usage.py +23 -34
- package/_bundled_plugin/scripts/workbench_schema.py +37 -1151
- package/_bundled_plugin/scripts/workbench_source_excerpt.py +11 -1
- package/_bundled_plugin/scripts/workbench_target.py +430 -142
- package/_bundled_plugin/scripts/workbench_validation.py +16 -27
- package/_bundled_plugin/shared/workbench-history-repairs.json +218 -0
- package/_bundled_plugin/shared/workbench-migrations.json +397 -0
- package/_bundled_plugin/skills/assess-patch-risk/SKILL.md +15 -4
- package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +1 -0
- package/_bundled_plugin/skills/cloud-findings/SKILL.md +54 -0
- package/_bundled_plugin/skills/cloud-findings/agents/openai.yaml +4 -0
- package/_bundled_plugin/skills/deep-security-scan/SKILL.md +3 -3
- package/_bundled_plugin/skills/deep-security-scan/agents/openai.yaml +1 -1
- package/_bundled_plugin/skills/finding-discovery/SKILL.md +3 -3
- package/_bundled_plugin/skills/propose-security-hardening/references/proposal-format.md +50 -20
- package/_bundled_plugin/skills/security-diff-scan/SKILL.md +8 -14
- package/_bundled_plugin/skills/security-diff-scan/agents/openai.yaml +1 -1
- package/_bundled_plugin/skills/security-scan/SKILL.md +22 -7
- package/_bundled_plugin/skills/security-scan/agents/openai.yaml +1 -1
- package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +1 -1
- package/_bundled_plugin/skills/security-scan/references/scan-artifacts-and-ledger.md +13 -1
- package/_bundled_plugin/skills/threat-model/SKILL.md +1 -1
- package/_bundled_plugin/skills/track-findings/SKILL.md +46 -178
- package/_bundled_plugin/skills/track-findings/agents/openai.yaml +1 -1
- package/_bundled_plugin/skills/track-findings/references/github-security-advisories.md +16 -24
- package/_bundled_plugin/skills/track-findings/references/jira.md +15 -61
- package/_bundled_plugin/skills/triage-finding/SKILL.md +50 -289
- package/_bundled_plugin/skills/triage-finding/agents/openai.yaml +2 -2
- package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +23 -43
- package/_bundled_plugin/skills/triage-finding/references/triage-result-contract.md +7 -1
- package/bin/codex-security.mjs +9 -2
- package/dist/api.d.ts +60 -10
- package/dist/api.d.ts.map +1 -1
- package/dist/api.js +803 -380
- package/dist/api.js.map +1 -1
- package/dist/artifact-export.d.ts +1 -1
- package/dist/artifact-export.d.ts.map +1 -1
- package/dist/artifact-export.js +28 -13
- package/dist/artifact-export.js.map +1 -1
- package/dist/auth.d.ts +2 -6
- package/dist/auth.d.ts.map +1 -1
- package/dist/auth.js +19 -9
- package/dist/auth.js.map +1 -1
- package/dist/bulk-scan-discovery.d.ts.map +1 -1
- package/dist/bulk-scan-discovery.js +1 -0
- package/dist/bulk-scan-discovery.js.map +1 -1
- package/dist/classify-severity.d.ts +26 -9
- package/dist/classify-severity.d.ts.map +1 -1
- package/dist/classify-severity.js +13 -30
- package/dist/classify-severity.js.map +1 -1
- package/dist/cli-help.d.ts.map +1 -1
- package/dist/cli-help.js +17 -13
- package/dist/cli-help.js.map +1 -1
- package/dist/cli-signals.d.ts +8 -0
- package/dist/cli-signals.d.ts.map +1 -0
- package/dist/cli-signals.js +28 -0
- package/dist/cli-signals.js.map +1 -0
- package/dist/cli.d.ts +4 -3
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +1087 -900
- package/dist/cli.js.map +1 -1
- package/dist/cloud-publish.d.ts.map +1 -1
- package/dist/cloud-publish.js +10 -9
- package/dist/cloud-publish.js.map +1 -1
- package/dist/codeowners.d.ts +19 -0
- package/dist/codeowners.d.ts.map +1 -0
- package/dist/codeowners.js +138 -0
- package/dist/codeowners.js.map +1 -0
- package/dist/codex-sdk-environment.d.ts +1 -0
- package/dist/codex-sdk-environment.d.ts.map +1 -1
- package/dist/codex-sdk-environment.js +40 -2
- package/dist/codex-sdk-environment.js.map +1 -1
- package/dist/component-plan.d.ts +2 -5
- package/dist/component-plan.d.ts.map +1 -1
- package/dist/component-plan.js +38 -30
- package/dist/component-plan.js.map +1 -1
- package/dist/component-scan.d.ts +6 -5
- package/dist/component-scan.d.ts.map +1 -1
- package/dist/component-scan.js +23 -35
- package/dist/component-scan.js.map +1 -1
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +64 -74
- package/dist/config.js.map +1 -1
- package/dist/contract.d.ts +15 -3
- package/dist/contract.d.ts.map +1 -1
- package/dist/contract.js +87 -252
- package/dist/contract.js.map +1 -1
- package/dist/cost-model.d.ts +13 -6
- package/dist/cost-model.d.ts.map +1 -1
- package/dist/cost-model.js +14 -4
- package/dist/cost-model.js.map +1 -1
- package/dist/cost.d.ts +10 -2
- package/dist/cost.d.ts.map +1 -1
- package/dist/cost.js +102 -104
- package/dist/cost.js.map +1 -1
- package/dist/custom-validation-prompt.d.ts.map +1 -1
- package/dist/custom-validation-prompt.js +6 -5
- package/dist/custom-validation-prompt.js.map +1 -1
- package/dist/custom-validation.d.ts +1 -2
- package/dist/custom-validation.d.ts.map +1 -1
- package/dist/custom-validation.js +9 -3
- package/dist/custom-validation.js.map +1 -1
- package/dist/deduplication/checkpointed-review.d.ts +4 -2
- package/dist/deduplication/checkpointed-review.d.ts.map +1 -1
- package/dist/deduplication/checkpointed-review.js +23 -9
- package/dist/deduplication/checkpointed-review.js.map +1 -1
- package/dist/deduplication/codex-review.d.ts +7 -1
- package/dist/deduplication/codex-review.d.ts.map +1 -1
- package/dist/deduplication/codex-review.js +126 -17
- package/dist/deduplication/codex-review.js.map +1 -1
- package/dist/deduplication/deduplication-prompts.d.ts +5 -2
- package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
- package/dist/deduplication/deduplication-prompts.js +18 -4
- package/dist/deduplication/deduplication-prompts.js.map +1 -1
- package/dist/deduplication/deduplication-reviewer.d.ts +26 -4
- package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
- package/dist/deduplication/deduplication-reviewer.js +57 -47
- package/dist/deduplication/deduplication-reviewer.js.map +1 -1
- package/dist/deduplication/deduplication.d.ts.map +1 -1
- package/dist/deduplication/deduplication.js +19 -51
- package/dist/deduplication/deduplication.js.map +1 -1
- package/dist/deduplication/diagnostics.d.ts +17 -0
- package/dist/deduplication/diagnostics.d.ts.map +1 -0
- package/dist/deduplication/diagnostics.js +5 -0
- package/dist/deduplication/diagnostics.js.map +1 -0
- package/dist/deduplication/finding-schema.d.ts.map +1 -1
- package/dist/deduplication/finding-schema.js +7 -1
- package/dist/deduplication/finding-schema.js.map +1 -1
- package/dist/deduplication/local.d.ts +31 -0
- package/dist/deduplication/local.d.ts.map +1 -0
- package/dist/deduplication/local.js +166 -0
- package/dist/deduplication/local.js.map +1 -0
- package/dist/deduplication/records-protocol.d.ts.map +1 -1
- package/dist/deduplication/records-protocol.js +11 -24
- package/dist/deduplication/records-protocol.js.map +1 -1
- package/dist/deduplication/records.d.ts +186 -11
- package/dist/deduplication/records.d.ts.map +1 -1
- package/dist/deduplication/records.js +10 -18
- package/dist/deduplication/records.js.map +1 -1
- package/dist/deduplication/scan.d.ts +9 -3
- package/dist/deduplication/scan.d.ts.map +1 -1
- package/dist/deduplication/scan.js +158 -39
- package/dist/deduplication/scan.js.map +1 -1
- package/dist/deep-config.d.ts +2 -1
- package/dist/deep-config.d.ts.map +1 -1
- package/dist/deep-config.js +4 -4
- package/dist/deep-config.js.map +1 -1
- package/dist/deep-progress.d.ts +2 -0
- package/dist/deep-progress.d.ts.map +1 -1
- package/dist/deep-progress.js +13 -10
- package/dist/deep-progress.js.map +1 -1
- package/dist/deep-scan.d.ts +20 -0
- package/dist/deep-scan.d.ts.map +1 -0
- package/dist/deep-scan.js +113 -0
- package/dist/deep-scan.js.map +1 -0
- package/dist/errors.d.ts +2 -0
- package/dist/errors.d.ts.map +1 -1
- package/dist/errors.js +2 -0
- package/dist/errors.js.map +1 -1
- package/dist/feedback.d.ts.map +1 -1
- package/dist/feedback.js +53 -21
- package/dist/feedback.js.map +1 -1
- package/dist/finding-catalogue.d.ts.map +1 -1
- package/dist/finding-catalogue.js +4 -8
- package/dist/finding-catalogue.js.map +1 -1
- package/dist/finding-normalization.d.ts +5 -0
- package/dist/finding-normalization.d.ts.map +1 -0
- package/dist/finding-normalization.js +120 -0
- package/dist/finding-normalization.js.map +1 -0
- package/dist/finding-retrieval.d.ts +9 -0
- package/dist/finding-retrieval.d.ts.map +1 -1
- package/dist/finding-retrieval.js.map +1 -1
- package/dist/finding-workflow.d.ts +13 -8
- package/dist/finding-workflow.d.ts.map +1 -1
- package/dist/finding-workflow.js +14 -6
- package/dist/finding-workflow.js.map +1 -1
- package/dist/findings-client.d.ts +2 -1
- package/dist/findings-client.d.ts.map +1 -1
- package/dist/findings-client.js +36 -9
- package/dist/findings-client.js.map +1 -1
- package/dist/findings-errors.d.ts +16 -0
- package/dist/findings-errors.d.ts.map +1 -0
- package/dist/findings-errors.js +24 -0
- package/dist/findings-errors.js.map +1 -0
- package/dist/findings-import.d.ts +1 -1
- package/dist/findings-import.d.ts.map +1 -1
- package/dist/findings-import.js +12 -30
- package/dist/findings-import.js.map +1 -1
- package/dist/github.d.ts.map +1 -1
- package/dist/github.js +7 -1
- package/dist/github.js.map +1 -1
- package/dist/import-scan.d.ts.map +1 -1
- package/dist/import-scan.js +48 -38
- package/dist/import-scan.js.map +1 -1
- package/dist/index.d.ts +8 -4
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/dist/knowledge-base.d.ts +7 -1
- package/dist/knowledge-base.d.ts.map +1 -1
- package/dist/knowledge-base.js +114 -46
- package/dist/knowledge-base.js.map +1 -1
- package/dist/linear.d.ts.map +1 -1
- package/dist/linear.js +2 -7
- package/dist/linear.js.map +1 -1
- package/dist/mock-scan.d.ts.map +1 -1
- package/dist/mock-scan.js +0 -1
- package/dist/mock-scan.js.map +1 -1
- package/dist/models.d.ts +0 -2
- package/dist/models.d.ts.map +1 -1
- package/dist/models.js.map +1 -1
- package/dist/multiscan.d.ts +9 -3
- package/dist/multiscan.d.ts.map +1 -1
- package/dist/multiscan.js +193 -126
- package/dist/multiscan.js.map +1 -1
- package/dist/owner-evidence.d.ts +10 -2
- package/dist/owner-evidence.d.ts.map +1 -1
- package/dist/owner-evidence.js +67 -8
- package/dist/owner-evidence.js.map +1 -1
- package/dist/patch-tui.d.ts.map +1 -1
- package/dist/patch-tui.js +3 -2
- package/dist/patch-tui.js.map +1 -1
- package/dist/project-config.js +3 -3
- package/dist/project-config.js.map +1 -1
- package/dist/provider-profile.d.ts +21 -0
- package/dist/provider-profile.d.ts.map +1 -0
- package/dist/provider-profile.js +133 -0
- package/dist/provider-profile.js.map +1 -0
- package/dist/publication-events.d.ts +6 -8
- package/dist/publication-events.d.ts.map +1 -1
- package/dist/publication-events.js +25 -50
- package/dist/publication-events.js.map +1 -1
- package/dist/publication-store.d.ts.map +1 -1
- package/dist/publication-store.js +40 -64
- package/dist/publication-store.js.map +1 -1
- package/dist/publication.d.ts +1 -2
- package/dist/publication.d.ts.map +1 -1
- package/dist/publication.js +2 -8
- package/dist/publication.js.map +1 -1
- package/dist/publish.d.ts +1 -5
- package/dist/publish.d.ts.map +1 -1
- package/dist/publish.js +109 -160
- package/dist/publish.js.map +1 -1
- package/dist/request-metadata.d.ts +9 -0
- package/dist/request-metadata.d.ts.map +1 -0
- package/dist/request-metadata.js +13 -0
- package/dist/request-metadata.js.map +1 -0
- package/dist/runtime.d.ts +15 -4
- package/dist/runtime.d.ts.map +1 -1
- package/dist/runtime.js +430 -138
- package/dist/runtime.js.map +1 -1
- package/dist/saved-scan-bootstrap.d.ts +14 -0
- package/dist/saved-scan-bootstrap.d.ts.map +1 -0
- package/dist/saved-scan-bootstrap.js +261 -0
- package/dist/saved-scan-bootstrap.js.map +1 -0
- package/dist/saved-scan.d.ts +1 -1
- package/dist/saved-scan.d.ts.map +1 -1
- package/dist/saved-scan.js +6 -12
- package/dist/saved-scan.js.map +1 -1
- package/dist/scan-activity.js +11 -8
- package/dist/scan-activity.js.map +1 -1
- package/dist/scan-comparison.d.ts +28 -15
- package/dist/scan-comparison.d.ts.map +1 -1
- package/dist/scan-comparison.js +276 -281
- package/dist/scan-comparison.js.map +1 -1
- package/dist/scan-dashboard.d.ts +3 -0
- package/dist/scan-dashboard.d.ts.map +1 -1
- package/dist/scan-dashboard.js +345 -77
- package/dist/scan-dashboard.js.map +1 -1
- package/dist/scan-history-renderer.d.ts.map +1 -1
- package/dist/scan-history-renderer.js +54 -13
- package/dist/scan-history-renderer.js.map +1 -1
- package/dist/scan-inputs.d.ts +6 -0
- package/dist/scan-inputs.d.ts.map +1 -0
- package/dist/scan-inputs.js +71 -0
- package/dist/scan-inputs.js.map +1 -0
- package/dist/scan-logs.d.ts +2 -3
- package/dist/scan-logs.d.ts.map +1 -1
- package/dist/scan-logs.js +12 -6
- package/dist/scan-logs.js.map +1 -1
- package/dist/scan-sessions.d.ts +4 -0
- package/dist/scan-sessions.d.ts.map +1 -1
- package/dist/scan-sessions.js +17 -0
- package/dist/scan-sessions.js.map +1 -1
- package/dist/scan-skill-paths.d.ts +8 -0
- package/dist/scan-skill-paths.d.ts.map +1 -0
- package/dist/scan-skill-paths.js +47 -0
- package/dist/scan-skill-paths.js.map +1 -0
- package/dist/security-policy-cli.d.ts.map +1 -1
- package/dist/security-policy-cli.js +7 -27
- package/dist/security-policy-cli.js.map +1 -1
- package/dist/security-policy.d.ts +9 -5
- package/dist/security-policy.d.ts.map +1 -1
- package/dist/security-policy.js +33 -14
- package/dist/security-policy.js.map +1 -1
- package/dist/server/api.d.ts +0 -1
- package/dist/server/api.d.ts.map +1 -1
- package/dist/server/api.js +0 -1
- package/dist/server/api.js.map +1 -1
- package/dist/server/embeddings.d.ts +3 -1
- package/dist/server/embeddings.d.ts.map +1 -1
- package/dist/server/embeddings.js +10 -3
- package/dist/server/embeddings.js.map +1 -1
- package/dist/server/errors.d.ts +5 -2
- package/dist/server/errors.d.ts.map +1 -1
- package/dist/server/errors.js +7 -0
- package/dist/server/errors.js.map +1 -1
- package/dist/server/sqlite-store.d.ts +0 -2
- package/dist/server/sqlite-store.d.ts.map +1 -1
- package/dist/server/sqlite-store.js +54 -44
- package/dist/server/sqlite-store.js.map +1 -1
- package/dist/server/storage.d.ts +0 -2
- package/dist/server/storage.d.ts.map +1 -1
- package/dist/server/storage.js.map +1 -1
- package/dist/severity-store.js +19 -24
- package/dist/severity-store.js.map +1 -1
- package/dist/standalone-validation-prompt.d.ts +2 -0
- package/dist/standalone-validation-prompt.d.ts.map +1 -0
- package/dist/standalone-validation-prompt.js +10 -0
- package/dist/standalone-validation-prompt.js.map +1 -0
- package/dist/suggest-owners.d.ts +4 -2
- package/dist/suggest-owners.d.ts.map +1 -1
- package/dist/suggest-owners.js +11 -5
- package/dist/suggest-owners.js.map +1 -1
- package/dist/targets.d.ts +11 -0
- package/dist/targets.d.ts.map +1 -1
- package/dist/targets.js +106 -47
- package/dist/targets.js.map +1 -1
- package/dist/trusted-executable.d.ts +2 -2
- package/dist/trusted-executable.d.ts.map +1 -1
- package/dist/trusted-executable.js +8 -6
- package/dist/trusted-executable.js.map +1 -1
- package/dist/value.js +7 -0
- package/dist/value.js.map +1 -1
- package/dist/version.js.map +1 -1
- package/dist/workbench-arguments.d.ts +3 -0
- package/dist/workbench-arguments.d.ts.map +1 -0
- package/dist/workbench-arguments.js +15 -0
- package/dist/workbench-arguments.js.map +1 -0
- package/dist/worker-progress.d.ts +1 -0
- package/dist/worker-progress.d.ts.map +1 -1
- package/dist/worker-progress.js +27 -12
- package/dist/worker-progress.js.map +1 -1
- package/docs/cli.md +1778 -0
- package/docs/findings-service.md +402 -0
- package/package.json +18 -19
- package/_bundled_plugin/schemas/tools/worker-threat-model.schema.json +0 -18
- package/_bundled_plugin/scripts/workbench_dashboard.py +0 -159
- package/_bundled_plugin/scripts/workbench_findings.py +0 -221
- package/_bundled_plugin/scripts/workbench_severity.py +0 -122
- package/_bundled_plugin/skills/assess-patch-risk/scripts/validate_patch_risk_assessment.py +0 -163
- package/dist/server/dashboard/THIRD_PARTY_NOTICES.txt +0 -276
- package/dist/server/dashboard/app.css +0 -2
- package/dist/server/dashboard/app.js +0 -66
- package/dist/server/dashboard/index.html +0 -18
- package/dist/server/dashboard-types.d.ts +0 -48
- package/dist/server/dashboard-types.d.ts.map +0 -1
- package/dist/server/dashboard-types.js +0 -2
- package/dist/server/dashboard-types.js.map +0 -1
- package/dist/server/dashboard.d.ts +0 -6
- package/dist/server/dashboard.d.ts.map +0 -1
- package/dist/server/dashboard.js +0 -59
- package/dist/server/dashboard.js.map +0 -1
- package/dist/server/index.d.ts +0 -2
- package/dist/server/index.d.ts.map +0 -1
- package/dist/server/index.js +0 -6
- package/dist/server/index.js.map +0 -1
- package/dist/server/routes.d.ts +0 -7
- package/dist/server/routes.d.ts.map +0 -1
- package/dist/server/routes.js +0 -98
- package/dist/server/routes.js.map +0 -1
- package/dist/server/serve.d.ts +0 -2
- package/dist/server/serve.d.ts.map +0 -1
- package/dist/server/serve.js +0 -28
- package/dist/server/serve.js.map +0 -1
- package/dist/server/server.d.ts +0 -10
- package/dist/server/server.d.ts.map +0 -1
- package/dist/server/server.js +0 -16
- package/dist/server/server.js.map +0 -1
- package/dist/server/validation.d.ts +0 -17
- package/dist/server/validation.d.ts.map +0 -1
- package/dist/server/validation.js +0 -53
- package/dist/server/validation.js.map +0 -1
|
@@ -0,0 +1,402 @@
|
|
|
1
|
+
# Findings storage and deduplication
|
|
2
|
+
|
|
3
|
+
Saved scans and findings persist in the local workbench SQLite database.
|
|
4
|
+
Deduplication reads that database directly; no local HTTP service is needed.
|
|
5
|
+
The CLI can also publish to and deduplicate against independently operated
|
|
6
|
+
compatible endpoints through explicit `--findings-url` settings.
|
|
7
|
+
|
|
8
|
+
## Local service removal
|
|
9
|
+
|
|
10
|
+
The `serve` command (including `--port`), `start:server` script,
|
|
11
|
+
`dist/server/index.js` entrypoint, `startFindingsServer` SDK export, browser
|
|
12
|
+
dashboard, and findings-service Compose deployment have been removed.
|
|
13
|
+
`HOST`, `PORT`, and `CODEX_SECURITY_FINDINGS_IMAGE` no longer configure a bundled
|
|
14
|
+
service. The dashboard storage projection is also removed.
|
|
15
|
+
|
|
16
|
+
Existing SQLite databases, migrations, saved scans, findings, and duplicate
|
|
17
|
+
groups are retained. No data migration or deletion is performed. Keep any
|
|
18
|
+
existing service volume or state directory and back it up before changing
|
|
19
|
+
deployments; local deduplication uses the database selected by
|
|
20
|
+
`CODEX_SECURITY_STATE_DIR`, not a separate service volume automatically.
|
|
21
|
+
|
|
22
|
+
`@openai/codex-security/server` continues to export `OpenAiFindingEmbedder`,
|
|
23
|
+
`SqliteFindingsStore`, and their storage types for direct storage users.
|
|
24
|
+
|
|
25
|
+
For direct embedding/storage integrations, `OpenAiFindingEmbedder` accepts a
|
|
26
|
+
static key or `() => string | Promise<string>` as its first argument. It calls
|
|
27
|
+
the callback before each HTTP batch; the caller handles token acquisition.
|
|
28
|
+
Pass `fetch` as the second argument and the full endpoint URL as the third.
|
|
29
|
+
By default, the saved-scan deduplication APIs use environment credentials. A
|
|
30
|
+
custom SDK `embedding` binding can supply an adapter with its own credentials,
|
|
31
|
+
including an `OpenAiFindingEmbedder` with a renewable key callback.
|
|
32
|
+
|
|
33
|
+
Custom publication, explicit remote deduplication, Cloud publication, the
|
|
34
|
+
plugin MCP server, and Codex app-server are unchanged.
|
|
35
|
+
|
|
36
|
+
## Direct storage helpers
|
|
37
|
+
|
|
38
|
+
Direct callers of the retired Python findings helpers can use the retained Node
|
|
39
|
+
helpers from an installed plugin directory:
|
|
40
|
+
|
|
41
|
+
```bash
|
|
42
|
+
scripts/launch_codex_security_mcp --helper list-stored-findings < request.json
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
On Windows, use `scripts\launch_codex_security_mcp.cmd` with the same arguments
|
|
46
|
+
and JSON on stdin. For example, `request.json` selects the existing database:
|
|
47
|
+
|
|
48
|
+
```json
|
|
49
|
+
{
|
|
50
|
+
"stateDirectory": "/absolute/path/to/state",
|
|
51
|
+
"payload": { "limit": 50, "offset": 0 }
|
|
52
|
+
}
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
Use an absolute Windows path on Windows. The retained helper commands accept
|
|
56
|
+
these `payload` fields:
|
|
57
|
+
|
|
58
|
+
| Command | Payload |
|
|
59
|
+
| --------------------------- | ------------------------------------------------------------------------------------------------------- |
|
|
60
|
+
| `store-findings` | `entries` containing finding and embedding records; optional `repositoryId`. |
|
|
61
|
+
| `list-stored-findings` | Positive integer `limit` and non-negative integer `offset`. |
|
|
62
|
+
| `find-potential-duplicates` | `findingId` and `scope`: either `{ "repositoryId": "REPOSITORY_ID" }` or `{ "allRepositories": true }`. |
|
|
63
|
+
| `store-dedupe-groups` | `groups`, an array of finding-ID arrays. |
|
|
64
|
+
| `list-dedupe-groups` | `findingId`. |
|
|
65
|
+
|
|
66
|
+
Retained scan commands such as `workbench_db.py list-findings` keep their existing
|
|
67
|
+
interface. The dashboard projection is removed along with the browser dashboard.
|
|
68
|
+
|
|
69
|
+
## Publish a scan
|
|
70
|
+
|
|
71
|
+
Send a completed scan to an independently operated compatible endpoint:
|
|
72
|
+
|
|
73
|
+
```bash
|
|
74
|
+
codex-security publish scan --scan SCAN_ID --to custom \
|
|
75
|
+
--findings-url https://findings.example.com --json
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
`--findings-url` is required. The client appends `/v1/bulk/findings` to this
|
|
79
|
+
base URL, preserving any base path. Custom endpoints must implement that API
|
|
80
|
+
and return the stored finding IDs.
|
|
81
|
+
|
|
82
|
+
Publication sends the complete sealed findings and the manifest's
|
|
83
|
+
`scan.target.targetId` as `repositoryId`. It leaves the scan artifacts unchanged
|
|
84
|
+
and does not forward model credentials. The endpoint is responsible for storing the batch before acknowledging it.
|
|
85
|
+
|
|
86
|
+
Use `--scan` for a saved scan, `--scan-dir` for an external scan directory, or
|
|
87
|
+
the interactive picker. Custom publication accepts one scan; CSV input and
|
|
88
|
+
Linear options do not apply. Add `--dry-run` to preview the payload without an
|
|
89
|
+
HTTP request. Upload failures and incomplete receipts fail the command. Uploads
|
|
90
|
+
are not automatically retried because a lost response may have been committed.
|
|
91
|
+
|
|
92
|
+
```typescript
|
|
93
|
+
import { publishScanToCustom } from "@openai/codex-security";
|
|
94
|
+
|
|
95
|
+
const receipt = await publishScanToCustom("/path/to/completed-scan", {
|
|
96
|
+
findingsUrl: "https://findings.example.com",
|
|
97
|
+
// dryRun: true,
|
|
98
|
+
// signal: controller.signal,
|
|
99
|
+
});
|
|
100
|
+
console.log(receipt.repositoryId, receipt.findingIds);
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
## Compatible endpoint contract
|
|
104
|
+
|
|
105
|
+
The retained HTTP clients use these endpoints on the supplied base URL,
|
|
106
|
+
preserving its base path:
|
|
107
|
+
|
|
108
|
+
| Method | Path | Response |
|
|
109
|
+
| ------ | --------------------------------------- | ------------------------------------------------------------------------ |
|
|
110
|
+
| `POST` | `/v1/bulk/findings` | An array acknowledging all submitted finding IDs; order does not matter. |
|
|
111
|
+
| `GET` | `/v1/finding/{id}/potential-duplicates` | `{finding, potentialDuplicates}` containing complete finding records. |
|
|
112
|
+
| `POST` | `/v1/dedupe-groups` | A successful JSON acknowledgement, such as `{}`. |
|
|
113
|
+
|
|
114
|
+
Publication sends `{findings, repositoryId}`. Candidate requests include either
|
|
115
|
+
`repositoryId` or `allRepositories=true`. Group writes send
|
|
116
|
+
`{groups: [[findingId, ...], ...]}`; repeated membership must be idempotent for
|
|
117
|
+
workflow retries. Both POST endpoints must persist their writes before
|
|
118
|
+
acknowledging them and return a JSON body. An explicit URL selects this remote
|
|
119
|
+
contract instead of local SQLite. This package no longer implements or hosts the HTTP endpoints.
|
|
120
|
+
|
|
121
|
+
SDK findings client failures preserve the endpoint's error code and message with
|
|
122
|
+
the HTTP status. Other responses retain the HTTP-status diagnostic. Retry
|
|
123
|
+
behavior uses the HTTP status and `Retry-After`.
|
|
124
|
+
|
|
125
|
+
## Deduplicate a scan
|
|
126
|
+
|
|
127
|
+
Saved-scan deduplication uses local SQLite by default. No findings service or
|
|
128
|
+
publication step is required:
|
|
129
|
+
|
|
130
|
+
```bash
|
|
131
|
+
codex-security dedupe --scan SCAN_ID --json
|
|
132
|
+
```
|
|
133
|
+
|
|
134
|
+
See [local embedding requirements](#local-embeddings-and-backups) for endpoint,
|
|
135
|
+
credential, and vector compatibility.
|
|
136
|
+
|
|
137
|
+
The CLI prepares missing or stale embeddings for the local repository's stored
|
|
138
|
+
findings, searches them, and saves reviewed duplicate groups in the workbench
|
|
139
|
+
database. Ordinary scans do not generate embeddings automatically. Fresh
|
|
140
|
+
duplicate reviews still need the configured model provider.
|
|
141
|
+
|
|
142
|
+
Local scope uses the scan's `targetId`, which identifies its local checkout.
|
|
143
|
+
Preparation checks this identity against the approved checkout and existing
|
|
144
|
+
target registration before reading findings. A detached scan directory must use
|
|
145
|
+
its original local target (including registered imports); artifacts cannot select
|
|
146
|
+
another checkout's stored corpus. The explicit findings-service mode remains
|
|
147
|
+
available for remotely stored artifacts. Separate clones are not automatically
|
|
148
|
+
combined. `--all-repositories` searches
|
|
149
|
+
the selected local database, including untagged imports. Historical scan IDs
|
|
150
|
+
select logical findings using their current stored bodies; dedupe does not
|
|
151
|
+
replace newer bodies with old scan artifacts. A local database does not include
|
|
152
|
+
findings stored only in a separate Docker volume or remote service.
|
|
153
|
+
|
|
154
|
+
To retain a centralized findings corpus, publish the scan first, or import its
|
|
155
|
+
findings with `repositoryId`, and explicitly select the service:
|
|
156
|
+
|
|
157
|
+
```bash
|
|
158
|
+
codex-security dedupe --scan SCAN_ID --findings-url https://findings.example.com --json
|
|
159
|
+
```
|
|
160
|
+
|
|
161
|
+
A scan or workflow selector is required. `--scan`
|
|
162
|
+
accepts a full ID, unique prefix, or `latest` for the current repository. The
|
|
163
|
+
scan must be complete, with sealed artifacts and a local checkout available.
|
|
164
|
+
Local `latest` lookup matches the exact checkout path without Git. Matching
|
|
165
|
+
across worktrees or clones additionally requires a Git executable outside all
|
|
166
|
+
saved scan targets. If an unrelated historical target includes the available
|
|
167
|
+
Git installation, use `codex-security dedupe --scan SCAN_ID` with an explicit
|
|
168
|
+
saved scan ID instead.
|
|
169
|
+
By default, candidates come from its manifest's `scan.target.targetId`. Use
|
|
170
|
+
`--all-repositories` to search the whole selected database or service. Explicit
|
|
171
|
+
`--findings-url` retains the existing remote lookup and publication behavior.
|
|
172
|
+
|
|
173
|
+
```typescript
|
|
174
|
+
import { deduplicateScan } from "@openai/codex-security";
|
|
175
|
+
|
|
176
|
+
const result = await deduplicateScan("scan_example_001", {
|
|
177
|
+
// findingsUrl: "https://findings.example.com", // Optional remote corpus.
|
|
178
|
+
concurrency: 8,
|
|
179
|
+
// allRepositories: true,
|
|
180
|
+
// signal: controller.signal,
|
|
181
|
+
});
|
|
182
|
+
console.log(result.duplicateGroups);
|
|
183
|
+
```
|
|
184
|
+
|
|
185
|
+
For a different embedding provider or model, both saved-scan SDK methods accept
|
|
186
|
+
an `embedding` binding. Reuse the `FindingEmbedder` interface: return one
|
|
187
|
+
`{ model, vector }` per input finding, in input order. The adapter owns its
|
|
188
|
+
credentials, tokenization, chunking, and provider request format.
|
|
189
|
+
|
|
190
|
+
```typescript
|
|
191
|
+
import { deduplicateScan, type FindingEmbedder } from "@openai/codex-security";
|
|
192
|
+
|
|
193
|
+
async function dedupeWithEmbeddings(scanId: string, embedder: FindingEmbedder) {
|
|
194
|
+
return await deduplicateScan(scanId, {
|
|
195
|
+
embedding: {
|
|
196
|
+
embedder,
|
|
197
|
+
model: "example-embedding-model",
|
|
198
|
+
dimensions: 384,
|
|
199
|
+
cacheNamespace: "example-provider:document-v1",
|
|
200
|
+
},
|
|
201
|
+
});
|
|
202
|
+
}
|
|
203
|
+
```
|
|
204
|
+
|
|
205
|
+
Choose a stable namespace identifying the actual vector space and preprocessing
|
|
206
|
+
version, including any provider or model revision that changes the vectors.
|
|
207
|
+
Changing the namespace, model, or dimensions refreshes cached vectors. Do not
|
|
208
|
+
put credentials in the namespace. The local cache keeps one vector per finding;
|
|
209
|
+
switching spaces replaces it, and concurrent runs with different spaces may
|
|
210
|
+
need a retry. `embedding` cannot be combined with `findingsUrl`, whose service
|
|
211
|
+
owns embedding preparation. Without a binding, the existing OpenAI adapter and
|
|
212
|
+
endpoint setting apply.
|
|
213
|
+
|
|
214
|
+
For a sealed scan directory outside local history, supply the checkout:
|
|
215
|
+
|
|
216
|
+
```typescript
|
|
217
|
+
import { deduplicateScanDirectory } from "@openai/codex-security";
|
|
218
|
+
|
|
219
|
+
const result = await deduplicateScanDirectory("/path/to/completed-scan", {
|
|
220
|
+
repository: "/path/to/repository",
|
|
221
|
+
// expectedScanId: "scan_example_001",
|
|
222
|
+
// concurrency: 8,
|
|
223
|
+
// allRepositories: true,
|
|
224
|
+
// signal: controller.signal,
|
|
225
|
+
});
|
|
226
|
+
console.log(result.duplicateGroups);
|
|
227
|
+
```
|
|
228
|
+
|
|
229
|
+
The CLI and SDK return the same result:
|
|
230
|
+
|
|
231
|
+
```json
|
|
232
|
+
{
|
|
233
|
+
"scanId": "scan_example_001",
|
|
234
|
+
"uniqueFindingIds": ["csf_852f90d6e1177502ff113d4a"],
|
|
235
|
+
"duplicateGroups": [],
|
|
236
|
+
"deduplicationStatus": "completed"
|
|
237
|
+
}
|
|
238
|
+
```
|
|
239
|
+
|
|
240
|
+
`uniqueFindingIds` contains one representative for each selected finding after
|
|
241
|
+
accepted groups are collapsed. A representative can come from outside the scan.
|
|
242
|
+
Each group lists its canonical finding first: highest reported severity, then
|
|
243
|
+
finding ID to break ties. Group associations are saved before returning success;
|
|
244
|
+
the original findings and scan artifacts remain unchanged.
|
|
245
|
+
|
|
246
|
+
If a model refuses a review, the result uses `completed_with_refusals` and adds
|
|
247
|
+
`refusals`. Each entry contains `decision: "NO_DECISION"`, `stage`, `model`,
|
|
248
|
+
`findingIds`, and `reason`. Screening entries list the anchor first, then its
|
|
249
|
+
candidates. Refused pairs stay separate, including through indirect groups;
|
|
250
|
+
their findings are not confirmed unique. The CLI logs refusals to stderr and
|
|
251
|
+
exits successfully after saving the other accepted groups.
|
|
252
|
+
|
|
253
|
+
### Reviews, concurrency, and failures
|
|
254
|
+
|
|
255
|
+
By default, deduplication retrieves all candidate neighborhoods, screens them
|
|
256
|
+
with `gpt-5.6-luna` at `xhigh`, then independently reviews nominated pairs with
|
|
257
|
+
`gpt-5.6-sol` at `high`. The host's Codex `model` and `model_reasoning_effort`
|
|
258
|
+
settings override these defaults for both stages. Provider selection uses the
|
|
259
|
+
existing Codex configuration; embedding configuration is separate. Screening
|
|
260
|
+
and pair-review permissions stay attached to their stages regardless of model name.
|
|
261
|
+
Accepted pairs form groups only when no reviewed `DISTINCT` decision or refusal
|
|
262
|
+
contradicts the group. Saved-scan pair reviews return a decision and rationale;
|
|
263
|
+
they do not generate replacement findings. The host chooses representatives
|
|
264
|
+
from the original records. Host-provided records reviews retain their full
|
|
265
|
+
merged-finding contract.
|
|
266
|
+
|
|
267
|
+
Local reviews receive the stored repository associations separately from the
|
|
268
|
+
finding text. When the current document matches a saved scan occurrence, this
|
|
269
|
+
context also includes its recorded revision and working-tree snapshot digest;
|
|
270
|
+
missing occurrence context is omitted rather than inferred from the current
|
|
271
|
+
checkout. A file in the selected checkout can establish that checkout's
|
|
272
|
+
current source; it cannot stand in for another repository or a historical
|
|
273
|
+
revision. Matching paths or snippets alone do not establish a shared maintained
|
|
274
|
+
control across repositories. The review does not gain permission to open other
|
|
275
|
+
checkouts from their stored associations.
|
|
276
|
+
|
|
277
|
+
The default concurrency is 8. Set `--concurrency N` or SDK `concurrency: N` to
|
|
278
|
+
change it; use 1 for serial execution.
|
|
279
|
+
|
|
280
|
+
Reviews run on the SDK/CLI host using its Codex sign-in or environment API key.
|
|
281
|
+
For the built-in OpenAI provider, an available `OPENAI_API_KEY` (or fallback
|
|
282
|
+
`CODEX_API_KEY`) is also used to
|
|
283
|
+
authenticate reviews, even when Codex is already signed in. The built-in
|
|
284
|
+
embedding adapter uses the same key selection. An embedding-only key therefore
|
|
285
|
+
does not select ChatGPT authentication for reviews. A custom SDK embedding
|
|
286
|
+
adapter can own separate embedding credentials while reviews use the host's
|
|
287
|
+
normal Codex authentication. Review credentials are not sent to the findings
|
|
288
|
+
service. Each review receives complete
|
|
289
|
+
original findings and may inspect the approved local checkout. Reviews preserve
|
|
290
|
+
severity and priority rather than reassessing them. The baseline filesystem is
|
|
291
|
+
read-only and excludes credentials and Codex state. Screening denies approval
|
|
292
|
+
requests; pair reviews use Codex's automatic approval reviewer. Web, plugins,
|
|
293
|
+
and inherited MCP servers are disabled. Finding content and linked tickets do
|
|
294
|
+
not authorize access to another target.
|
|
295
|
+
|
|
296
|
+
Reviews are ephemeral and reuse Codex's configured SQLite storage. They do not
|
|
297
|
+
rebuild a temporary copy of the caller's session history for every pair. Explicit
|
|
298
|
+
`sqlite_home` and `CODEX_SQLITE_HOME` settings remain effective, and the native
|
|
299
|
+
state directory is excluded from the review's source access.
|
|
300
|
+
|
|
301
|
+
The CLI reports preparation, review progress, and native warnings on stderr;
|
|
302
|
+
JSON results remain on stdout. The existing `CODEX_SECURITY_LOG_LEVEL=debug`
|
|
303
|
+
(or `LOG_LEVEL=debug`) includes structured review diagnostics with thread,
|
|
304
|
+
turn, and command identifiers, command failures, and native token-usage events.
|
|
305
|
+
Usage counters are cumulative per native thread; do not add every update.
|
|
306
|
+
SDK callers can receive the same events through `onDiagnostic`. Observer
|
|
307
|
+
failures do not interrupt reviews or discard completed results.
|
|
308
|
+
|
|
309
|
+
Models must submit a validated decision. Invalid output and eligible transient
|
|
310
|
+
failures are retried automatically; HTTP retries honor `Retry-After`.
|
|
311
|
+
|
|
312
|
+
Cancellation, authentication/configuration errors, permanent HTTP errors, and
|
|
313
|
+
required-source-access blockers are not retried. Refusals are not retried or
|
|
314
|
+
sent to another model. If candidate retrieval or review still fails, the
|
|
315
|
+
operation fails without posting groups.
|
|
316
|
+
A failed group-write request may already have committed; resubmitting the same
|
|
317
|
+
memberships does not create duplicate groups. Non-cancellation review failures
|
|
318
|
+
throw `DeduplicationReviewError`, with diagnostic text and `metadata` for the
|
|
319
|
+
stage, model, category, attempt count, and reason.
|
|
320
|
+
|
|
321
|
+
Empty scans and findings without eligible candidates make no review calls.
|
|
322
|
+
Other scans can require multiple calls per finding. Completion means the
|
|
323
|
+
retrieval, review, and group write finished; it does not mean that every pair
|
|
324
|
+
in the database was compared. Use Ctrl-C or SIGTERM in the CLI, or an
|
|
325
|
+
`AbortSignal` in the SDK, to cancel. This workflow is separate from Deep Scan's
|
|
326
|
+
internal reducer.
|
|
327
|
+
|
|
328
|
+
### Resume a findings workflow
|
|
329
|
+
|
|
330
|
+
Use one workflow ID across scanning and local deduplication:
|
|
331
|
+
|
|
332
|
+
```bash
|
|
333
|
+
codex-security scan /path/to/repository --workflow-id run-001
|
|
334
|
+
codex-security dedupe --workflow-id run-001 --json
|
|
335
|
+
```
|
|
336
|
+
|
|
337
|
+
Local workflows save review checkpoints and group-write retries without
|
|
338
|
+
publication. A workflow remains bound to its original local database or remote
|
|
339
|
+
URL; use a new workflow ID to switch backends. Cancellation can retain completed
|
|
340
|
+
embedding preparation for retry; sealed scan artifacts remain unchanged.
|
|
341
|
+
|
|
342
|
+
For an explicitly selected remote corpus, use `--findings-url` with a separate
|
|
343
|
+
workflow ID:
|
|
344
|
+
|
|
345
|
+
```bash
|
|
346
|
+
codex-security scan /path/to/repository --workflow-id remote-001
|
|
347
|
+
codex-security publish scan --workflow-id remote-001 --to custom --findings-url https://findings.example.com
|
|
348
|
+
codex-security dedupe --workflow-id remote-001 --findings-url https://findings.example.com --json
|
|
349
|
+
```
|
|
350
|
+
|
|
351
|
+
The SDK equivalents are `workflowId` on `ScanOptions`,
|
|
352
|
+
`PublishScanToCustomOptions`, and `DeduplicateScanOptions`. Repeat the sequence
|
|
353
|
+
with the same ID after an interruption. Completed scans, acknowledged uploads,
|
|
354
|
+
and validated reviews are reused. This resumes completed stages, not model
|
|
355
|
+
turns inside an unfinished scan. Normal output-directory checks still apply.
|
|
356
|
+
|
|
357
|
+
A remote workflow can begin by publishing an existing completed scan. Publication
|
|
358
|
+
and dedupe can use its ID instead of `--scan`; an explicit scan must match.
|
|
359
|
+
With both `--workflow-id` and `--findings-url`, dedupe completes publication
|
|
360
|
+
only when its receipt is missing. Changing the bound scan,
|
|
361
|
+
destination, or repository scope requires a different ID. Use one coordinating
|
|
362
|
+
process per workflow. Dry runs do not advance it.
|
|
363
|
+
|
|
364
|
+
Workflow state and checkpoints live in the local workbench database under
|
|
365
|
+
`CODEX_SECURITY_STATE_DIR`, outside the sealed artifacts. Completed reviews are
|
|
366
|
+
reused only when their findings, source checkout and contents, scope, model
|
|
367
|
+
settings, Codex configuration/version, and review contract still match. Source
|
|
368
|
+
changes during review stop the attempt before group writes. Resume to review
|
|
369
|
+
the changed source. You can change concurrency without invalidating checkpoints.
|
|
370
|
+
|
|
371
|
+
Before posting groups, the workflow saves the reviewed result and write payload.
|
|
372
|
+
If acknowledgement is lost, resuming replays that payload without new model
|
|
373
|
+
calls. Membership-based group IDs prevent duplicates. Completed workflows,
|
|
374
|
+
including empty results and `completed_with_refusals`, return their saved result.
|
|
375
|
+
Use a new ID for a fresh review or to retry a refusal after resolving its cause.
|
|
376
|
+
|
|
377
|
+
### Use a host-provided model backend
|
|
378
|
+
|
|
379
|
+
`codex-security dedupe --records` accepts a JSON-RPC run over stdin and emits
|
|
380
|
+
serial `review.run` requests on stdout. The SDK equivalent is
|
|
381
|
+
`deduplicateRecords(input, { reviewRunner, signal })`. These entry points need
|
|
382
|
+
no saved scan or findings service and perform no local model execution or
|
|
383
|
+
persistence. The host supplies original observations and candidate links.
|
|
384
|
+
See the [records protocol and Python example](dedupe-records.md).
|
|
385
|
+
|
|
386
|
+
## Local embeddings and backups
|
|
387
|
+
|
|
388
|
+
`CODEX_SECURITY_STATE_DIR` selects the directory containing `workbench.sqlite3`.
|
|
389
|
+
Without an override, the CLI uses its default state directory. Back up the
|
|
390
|
+
entire state directory with no scans or deduplication running. Existing
|
|
391
|
+
append-only migrations retain finding identities and scan history.
|
|
392
|
+
|
|
393
|
+
With the default built-in adapter, new embeddings require `OPENAI_API_KEY` or
|
|
394
|
+
`CODEX_API_KEY`;
|
|
395
|
+
`OPENAI_API_KEY` takes precedence. ChatGPT login alone is insufficient.
|
|
396
|
+
`CODEX_SECURITY_EMBEDDINGS_URL` selects a
|
|
397
|
+
full embeddings endpoint URL (default `https://api.openai.com/v1/embeddings`).
|
|
398
|
+
The endpoint must support the OpenAI embeddings request and response protocol,
|
|
399
|
+
including `text-embedding-3-large`, 1,536-dimensional float vectors, and token
|
|
400
|
+
array inputs. Requests encode the complete finding JSON with `cl100k_base` and
|
|
401
|
+
send the API key as a bearer token. Long inputs are combined without truncation.
|
|
402
|
+
Cached compatible vectors avoid new requests.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@openai/codex-security",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.3.0",
|
|
4
4
|
"description": "TypeScript SDK and CLI for Codex Security",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"author": "OpenAI",
|
|
@@ -31,7 +31,8 @@
|
|
|
31
31
|
"./schemas/project-config.schema.json": "./schemas/project-config.schema.json"
|
|
32
32
|
},
|
|
33
33
|
"bin": {
|
|
34
|
-
"codex-security": "./bin/codex-security.mjs"
|
|
34
|
+
"codex-security": "./bin/codex-security.mjs",
|
|
35
|
+
"cs": "./bin/codex-security.mjs"
|
|
35
36
|
},
|
|
36
37
|
"files": [
|
|
37
38
|
"bin",
|
|
@@ -40,6 +41,8 @@
|
|
|
40
41
|
"_bundled_plugin",
|
|
41
42
|
"LICENSE",
|
|
42
43
|
"README.md",
|
|
44
|
+
"docs/cli.md",
|
|
45
|
+
"docs/findings-service.md",
|
|
43
46
|
"docs/dedupe-records.md"
|
|
44
47
|
],
|
|
45
48
|
"publishConfig": {
|
|
@@ -49,64 +52,60 @@
|
|
|
49
52
|
]
|
|
50
53
|
},
|
|
51
54
|
"dependencies": {
|
|
52
|
-
"@inquirer/prompts": "8.7.
|
|
55
|
+
"@inquirer/prompts": "8.7.3",
|
|
53
56
|
"@linear/sdk": "97.0.0",
|
|
54
57
|
"@octokit/core": "7.0.8",
|
|
55
|
-
"@openai/codex": "0.162.
|
|
56
|
-
"@openai/codex-sdk": "0.162.
|
|
58
|
+
"@openai/codex": "0.162.1",
|
|
59
|
+
"@openai/codex-sdk": "0.162.1",
|
|
57
60
|
"ajv": "8.20.0",
|
|
58
61
|
"fflate": "0.8.3",
|
|
59
|
-
"incur": "0.
|
|
60
|
-
"ink": "
|
|
62
|
+
"incur": "0.7.0",
|
|
63
|
+
"ink": "8.0.0",
|
|
61
64
|
"js-tiktoken": "1.0.21",
|
|
62
65
|
"papaparse": "5.7.0",
|
|
63
|
-
"pdfjs-dist": "6.
|
|
66
|
+
"pdfjs-dist": "6.4.299",
|
|
64
67
|
"react": "19.3.0",
|
|
65
68
|
"semver": "7.8.5",
|
|
66
69
|
"smol-toml": "1.9.0",
|
|
70
|
+
"string-width": "8.3.0",
|
|
71
|
+
"strip-ansi": "7.2.0",
|
|
67
72
|
"yaml": "2.9.1",
|
|
68
73
|
"yauzl": "3.4.0",
|
|
69
74
|
"zod": "4.6.5"
|
|
70
75
|
},
|
|
71
76
|
"devDependencies": {
|
|
72
|
-
"@openai/apps-sdk-ui": "0.2.2",
|
|
73
77
|
"@stryker-mutator/core": "10.0.0",
|
|
74
|
-
"@tailwindcss/postcss": "4.3.3",
|
|
75
78
|
"@types/bun": "1.4.2",
|
|
76
|
-
"@types/node": "26.6.
|
|
79
|
+
"@types/node": "26.6.4",
|
|
77
80
|
"@types/papaparse": "5.5.2",
|
|
78
81
|
"@types/react": "19.3.0",
|
|
79
|
-
"@types/react-dom": "19.3.0",
|
|
80
82
|
"@types/semver": "7.8.0",
|
|
81
83
|
"@types/yauzl": "3.4.0",
|
|
82
84
|
"esbuild": "0.28.2",
|
|
83
85
|
"fast-check": "4.10.2",
|
|
84
86
|
"ink-testing-library": "4.0.0",
|
|
85
87
|
"json-schema-to-typescript": "16.0.0",
|
|
88
|
+
"json5": "2.2.3",
|
|
86
89
|
"minimatch": "10.2.6",
|
|
87
|
-
"postcss": "8.5.28",
|
|
88
90
|
"prettier": "3.9.9",
|
|
89
|
-
"react-dom": "19.3.0",
|
|
90
91
|
"saxes": "6.0.0",
|
|
91
|
-
"tailwindcss": "4.3.3",
|
|
92
92
|
"typescript": "7.0.2"
|
|
93
93
|
},
|
|
94
|
-
"gitHead": "
|
|
94
|
+
"gitHead": "5c5239dd8062a7d00916c4bc0d5aeaa3ed0c5477",
|
|
95
95
|
"scripts": {
|
|
96
96
|
"audit:prod": "pnpm audit --prod --audit-level high",
|
|
97
97
|
"clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
|
|
98
|
-
"build": "node --run clean && node scripts/generate-deep-defaults.mjs && tsc -p tsconfig.build.json && node scripts/generate-project-config-schema.mjs
|
|
98
|
+
"build": "node --run clean && node scripts/generate-deep-defaults.mjs && tsc -p tsconfig.build.json && node scripts/generate-project-config-schema.mjs",
|
|
99
99
|
"build:ci": "tsc -p tsconfig.ci.json",
|
|
100
100
|
"build:evals": "node --run build && tsc -p ../../evals/tsconfig.json",
|
|
101
101
|
"build:examples": "tsc -p tsconfig.examples.json",
|
|
102
102
|
"build:plugin": "node scripts/build-plugin.mjs",
|
|
103
103
|
"check:plugin-source": "node scripts/check-plugin-source.mjs",
|
|
104
104
|
"check:package": "node scripts/check-package.mjs",
|
|
105
|
-
"format": "prettier --check --ignore-path .gitignore --ignore-path .prettierignore \"**/*.{cjs,mjs,js,ts,mts,tsx,json
|
|
105
|
+
"format": "prettier --check --ignore-path .gitignore --ignore-path .prettierignore \"**/*.{cjs,mjs,js,ts,mts,tsx,json}\" \"../../.github/scripts/*.mts\" \"../../examples/custom-validation/*.mts\" \"../../plugins/codex-security/native/*.mts\" \"../../evals/{deep-reducer,secret-discovery}/*.mts\" \"../../evals/triage-finding/{assertions,scripts,sastbench/assertions,sastbench/scripts}/*.mts\" \"../../evals/triage-finding/types.ts\" \"../../evals/tsconfig.json\" && node scripts/check-markdown.mjs",
|
|
106
106
|
"generate:models": "node scripts/generate-models.cjs",
|
|
107
107
|
"generate:models:check": "node scripts/generate-models.cjs --check",
|
|
108
108
|
"lint": "tsc --noEmit",
|
|
109
|
-
"start:server": "node dist/server/index.js",
|
|
110
109
|
"test": "node --run build:plugin && bun test --timeout 30000 ./tests-ts",
|
|
111
110
|
"test:ci": "node -e \"require('node:fs').mkdirSync('reports',{recursive:true})\" && pnpm run test --coverage --coverage-reporter=text --coverage-reporter=lcov --reporter=junit --reporter-outfile=reports/junit.xml",
|
|
112
111
|
"test:mcp": "node --run build:plugin && pnpm --dir ../../plugins/codex-security/mcp-app run test:mcp",
|
|
@@ -1,18 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
-
"$id": "codex-security://schemas/tools/worker-threat-model.schema.json",
|
|
4
|
-
"$defs": {
|
|
5
|
-
"recordWorkerThreatModelInput": {
|
|
6
|
-
"type": "object",
|
|
7
|
-
"properties": {
|
|
8
|
-
"content": {
|
|
9
|
-
"type": "string",
|
|
10
|
-
"minLength": 1,
|
|
11
|
-
"pattern": "\\S"
|
|
12
|
-
}
|
|
13
|
-
},
|
|
14
|
-
"required": ["content"],
|
|
15
|
-
"additionalProperties": false
|
|
16
|
-
}
|
|
17
|
-
}
|
|
18
|
-
}
|