@openai/codex-security 0.1.31 → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +442 -2434
- package/_bundled_plugin/.app.json +5 -1
- package/_bundled_plugin/.codex-plugin/plugin.json +9 -5
- package/_bundled_plugin/.mcp.json +3 -0
- package/_bundled_plugin/examples/completed-scan/coverage.json +0 -1
- package/_bundled_plugin/examples/completed-scan/report.md +28 -26
- package/_bundled_plugin/examples/completed-scan/scan-manifest.json +1 -1
- package/_bundled_plugin/mcp/helpers.mjs +1 -0
- package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
- package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +7 -214
- package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
- package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
- package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
- package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
- package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
- package/_bundled_plugin/mcp/native/linux-x64-musl/unix.node +0 -0
- package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
- package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
- package/_bundled_plugin/mcp/permission-profile-preflight.mjs +563 -0
- package/_bundled_plugin/mcp/server.mjs +1 -0
- package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
- package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
- package/_bundled_plugin/preflight/capability-profiles.toml +0 -13
- package/_bundled_plugin/references/artifact-storage.md +5 -5
- package/_bundled_plugin/references/config-preflight.md +1 -5
- package/_bundled_plugin/references/core-scan.md +34 -10
- package/_bundled_plugin/references/final-report.md +13 -13
- package/_bundled_plugin/references/finding-detail-fields.md +90 -80
- package/_bundled_plugin/references/sarif-adapter.md +1 -1
- package/_bundled_plugin/references/scan-artifacts.md +3 -4
- package/_bundled_plugin/references/scan-contract.md +11 -6
- package/_bundled_plugin/references/scan-prologue.md +12 -0
- package/_bundled_plugin/references/security-guidance.md +2 -2
- package/_bundled_plugin/references/standalone-validation.md +11 -0
- package/_bundled_plugin/references/threat-model.md +2 -2
- package/_bundled_plugin/schemas/coverage.schema.json +23 -47
- package/_bundled_plugin/schemas/definitions/artifact-common.schema.json +2 -24
- package/_bundled_plugin/schemas/definitions/discovery-candidate.schema.json +49 -25
- package/_bundled_plugin/schemas/findings.schema.json +71 -192
- package/_bundled_plugin/schemas/scan-manifest.schema.json +83 -95
- package/_bundled_plugin/schemas/tools/candidate-attack-paths.schema.json +91 -83
- package/_bundled_plugin/schemas/tools/candidate-validations.schema.json +35 -64
- package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +5 -2
- package/_bundled_plugin/schemas/tools/discovery-candidates.schema.json +6 -55
- package/_bundled_plugin/schemas/tools/review-items.schema.json +2 -38
- package/_bundled_plugin/schemas/tools/scan-draft.schema.json +245 -356
- package/_bundled_plugin/scripts/codex_profile.mjs +239 -0
- package/_bundled_plugin/scripts/codex_session.mjs +53 -0
- package/_bundled_plugin/scripts/config_preflight.py +29 -69
- package/_bundled_plugin/scripts/deep_scan_config.py +9 -11
- package/_bundled_plugin/scripts/deep_scan_workbench.py +208 -363
- package/_bundled_plugin/scripts/filesystem_identity.py +1 -5
- package/_bundled_plugin/scripts/finalize_scan_contract.py +733 -375
- package/_bundled_plugin/scripts/finding_preview.py +81 -91
- package/_bundled_plugin/scripts/generate_in_scope_files.py +48 -102
- package/_bundled_plugin/scripts/generate_rank_input.py +117 -888
- package/_bundled_plugin/scripts/launch_codex_security_mcp +35 -6
- package/_bundled_plugin/scripts/launch_codex_security_mcp.cmd +5 -5
- package/_bundled_plugin/scripts/rank_preview.py +43 -902
- package/_bundled_plugin/scripts/report_projection.py +143 -219
- package/_bundled_plugin/scripts/snapshot_sqlite.py +6 -1
- package/_bundled_plugin/scripts/threat_model_projection.py +161 -0
- package/_bundled_plugin/scripts/validate_scan_contract.py +4 -34
- package/_bundled_plugin/scripts/validate_tracking_source.py +3 -13
- package/_bundled_plugin/scripts/windows_scan_local_files.py +59 -9
- package/_bundled_plugin/scripts/workbench/handoff.py +25 -50
- package/_bundled_plugin/scripts/workbench/runtime_toml.py +22 -0
- package/_bundled_plugin/scripts/workbench/storage.py +21 -6
- package/_bundled_plugin/scripts/workbench_cli.py +99 -190
- package/_bundled_plugin/scripts/workbench_constants.py +6 -14
- package/_bundled_plugin/scripts/workbench_db.py +524 -672
- package/_bundled_plugin/scripts/workbench_feedback.py +6 -3
- package/_bundled_plugin/scripts/workbench_finding_index.py +20 -7
- package/_bundled_plugin/scripts/workbench_finding_workflows.py +18 -4
- package/_bundled_plugin/scripts/workbench_local_dedupe.py +136 -0
- package/_bundled_plugin/scripts/workbench_native_indexes.py +28 -18
- package/_bundled_plugin/scripts/workbench_progress.py +26 -92
- package/_bundled_plugin/scripts/workbench_publication.py +77 -116
- package/_bundled_plugin/scripts/workbench_remediation.py +14 -20
- package/_bundled_plugin/scripts/workbench_saved_results.py +1402 -263
- package/_bundled_plugin/scripts/workbench_scan_history.py +57 -57
- package/_bundled_plugin/scripts/workbench_scan_start.py +109 -52
- package/_bundled_plugin/scripts/workbench_scan_usage.py +30 -49
- package/_bundled_plugin/scripts/workbench_schema.py +71 -1370
- package/_bundled_plugin/scripts/workbench_source_excerpt.py +16 -7
- package/_bundled_plugin/scripts/workbench_target.py +526 -150
- package/_bundled_plugin/scripts/workbench_target_state.py +1 -5
- package/_bundled_plugin/scripts/workbench_validation.py +19 -44
- package/_bundled_plugin/shared/workbench-history-repairs.json +218 -0
- package/_bundled_plugin/shared/workbench-migrations.json +397 -0
- package/_bundled_plugin/skills/assess-patch-risk/SKILL.md +15 -4
- package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +1 -0
- package/_bundled_plugin/skills/cloud-findings/SKILL.md +54 -0
- package/_bundled_plugin/skills/cloud-findings/agents/openai.yaml +4 -0
- package/_bundled_plugin/skills/deep-security-scan/SKILL.md +6 -6
- package/_bundled_plugin/skills/deep-security-scan/agents/openai.yaml +1 -1
- package/_bundled_plugin/skills/finding-discovery/SKILL.md +3 -3
- package/_bundled_plugin/skills/propose-security-hardening/references/proposal-format.md +50 -20
- package/_bundled_plugin/skills/security-diff-scan/SKILL.md +8 -14
- package/_bundled_plugin/skills/security-diff-scan/agents/openai.yaml +1 -1
- package/_bundled_plugin/skills/security-scan/SKILL.md +22 -7
- package/_bundled_plugin/skills/security-scan/agents/openai.yaml +1 -1
- package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +2 -2
- package/_bundled_plugin/skills/security-scan/references/scan-artifacts-and-ledger.md +13 -1
- package/_bundled_plugin/skills/threat-model/SKILL.md +2 -2
- package/_bundled_plugin/skills/track-findings/SKILL.md +46 -178
- package/_bundled_plugin/skills/track-findings/agents/openai.yaml +1 -1
- package/_bundled_plugin/skills/track-findings/references/github-security-advisories.md +16 -24
- package/_bundled_plugin/skills/track-findings/references/jira.md +15 -61
- package/_bundled_plugin/skills/triage-finding/SKILL.md +50 -289
- package/_bundled_plugin/skills/triage-finding/agents/openai.yaml +2 -2
- package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +23 -43
- package/_bundled_plugin/skills/triage-finding/references/triage-result-contract.md +7 -1
- package/bin/codex-security.mjs +9 -2
- package/dist/api.d.ts +63 -15
- package/dist/api.d.ts.map +1 -1
- package/dist/api.js +970 -553
- package/dist/api.js.map +1 -1
- package/dist/artifact-export.d.ts +70 -0
- package/dist/artifact-export.d.ts.map +1 -0
- package/dist/artifact-export.js +292 -0
- package/dist/artifact-export.js.map +1 -0
- package/dist/auth.d.ts +2 -6
- package/dist/auth.d.ts.map +1 -1
- package/dist/auth.js +27 -12
- package/dist/auth.js.map +1 -1
- package/dist/bulk-scan-discovery.d.ts +1 -0
- package/dist/bulk-scan-discovery.d.ts.map +1 -1
- package/dist/bulk-scan-discovery.js +9 -9
- package/dist/bulk-scan-discovery.js.map +1 -1
- package/dist/classify-scan-severity.d.ts.map +1 -1
- package/dist/classify-scan-severity.js +2 -5
- package/dist/classify-scan-severity.js.map +1 -1
- package/dist/classify-severity.d.ts +28 -17
- package/dist/classify-severity.d.ts.map +1 -1
- package/dist/classify-severity.js +16 -35
- package/dist/classify-severity.js.map +1 -1
- package/dist/cli-help.d.ts +3 -0
- package/dist/cli-help.d.ts.map +1 -0
- package/dist/cli-help.js +285 -0
- package/dist/cli-help.js.map +1 -0
- package/dist/cli-signals.d.ts +8 -0
- package/dist/cli-signals.d.ts.map +1 -0
- package/dist/cli-signals.js +28 -0
- package/dist/cli-signals.js.map +1 -0
- package/dist/cli.d.ts +22 -24
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +1660 -1556
- package/dist/cli.js.map +1 -1
- package/dist/cloud-publish.d.ts.map +1 -1
- package/dist/cloud-publish.js +11 -17
- package/dist/cloud-publish.js.map +1 -1
- package/dist/codeowners.d.ts +19 -0
- package/dist/codeowners.d.ts.map +1 -0
- package/dist/codeowners.js +138 -0
- package/dist/codeowners.js.map +1 -0
- package/dist/codex-prompt.d.ts.map +1 -1
- package/dist/codex-prompt.js +1 -2
- package/dist/codex-prompt.js.map +1 -1
- package/dist/codex-sdk-environment.d.ts +3 -0
- package/dist/codex-sdk-environment.d.ts.map +1 -0
- package/dist/codex-sdk-environment.js +68 -0
- package/dist/codex-sdk-environment.js.map +1 -0
- package/dist/component-plan.d.ts +2 -5
- package/dist/component-plan.d.ts.map +1 -1
- package/dist/component-plan.js +38 -34
- package/dist/component-plan.js.map +1 -1
- package/dist/component-scan.d.ts +7 -5
- package/dist/component-scan.d.ts.map +1 -1
- package/dist/component-scan.js +54 -44
- package/dist/component-scan.js.map +1 -1
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +93 -104
- package/dist/config.js.map +1 -1
- package/dist/contract.d.ts +15 -2
- package/dist/contract.d.ts.map +1 -1
- package/dist/contract.js +124 -348
- package/dist/contract.js.map +1 -1
- package/dist/cost-model.d.ts +13 -6
- package/dist/cost-model.d.ts.map +1 -1
- package/dist/cost-model.js +75 -34
- package/dist/cost-model.js.map +1 -1
- package/dist/cost.d.ts +10 -2
- package/dist/cost.d.ts.map +1 -1
- package/dist/cost.js +116 -134
- package/dist/cost.js.map +1 -1
- package/dist/custom-validation-prompt.d.ts.map +1 -1
- package/dist/custom-validation-prompt.js +7 -6
- package/dist/custom-validation-prompt.js.map +1 -1
- package/dist/custom-validation.d.ts +1 -2
- package/dist/custom-validation.d.ts.map +1 -1
- package/dist/custom-validation.js +23 -16
- package/dist/custom-validation.js.map +1 -1
- package/dist/deduplication/checkpointed-review.d.ts +4 -2
- package/dist/deduplication/checkpointed-review.d.ts.map +1 -1
- package/dist/deduplication/checkpointed-review.js +33 -20
- package/dist/deduplication/checkpointed-review.js.map +1 -1
- package/dist/deduplication/codex-review.d.ts +9 -1
- package/dist/deduplication/codex-review.d.ts.map +1 -1
- package/dist/deduplication/codex-review.js +129 -20
- package/dist/deduplication/codex-review.js.map +1 -1
- package/dist/deduplication/deduplication-prompts.d.ts +5 -2
- package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
- package/dist/deduplication/deduplication-prompts.js +18 -4
- package/dist/deduplication/deduplication-prompts.js.map +1 -1
- package/dist/deduplication/deduplication-reviewer.d.ts +26 -4
- package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
- package/dist/deduplication/deduplication-reviewer.js +59 -47
- package/dist/deduplication/deduplication-reviewer.js.map +1 -1
- package/dist/deduplication/deduplication.d.ts.map +1 -1
- package/dist/deduplication/deduplication.js +59 -113
- package/dist/deduplication/deduplication.js.map +1 -1
- package/dist/deduplication/diagnostics.d.ts +17 -0
- package/dist/deduplication/diagnostics.d.ts.map +1 -0
- package/dist/deduplication/diagnostics.js +5 -0
- package/dist/deduplication/diagnostics.js.map +1 -0
- package/dist/deduplication/finding-schema.d.ts.map +1 -1
- package/dist/deduplication/finding-schema.js +7 -1
- package/dist/deduplication/finding-schema.js.map +1 -1
- package/dist/deduplication/local.d.ts +31 -0
- package/dist/deduplication/local.d.ts.map +1 -0
- package/dist/deduplication/local.js +166 -0
- package/dist/deduplication/local.js.map +1 -0
- package/dist/deduplication/records-protocol.d.ts.map +1 -1
- package/dist/deduplication/records-protocol.js +12 -28
- package/dist/deduplication/records-protocol.js.map +1 -1
- package/dist/deduplication/records.d.ts +188 -12
- package/dist/deduplication/records.d.ts.map +1 -1
- package/dist/deduplication/records.js +34 -24
- package/dist/deduplication/records.js.map +1 -1
- package/dist/deduplication/review.d.ts +7 -0
- package/dist/deduplication/review.d.ts.map +1 -1
- package/dist/deduplication/review.js.map +1 -1
- package/dist/deduplication/scan.d.ts +9 -3
- package/dist/deduplication/scan.d.ts.map +1 -1
- package/dist/deduplication/scan.js +159 -44
- package/dist/deduplication/scan.js.map +1 -1
- package/dist/deep-config.d.ts +2 -1
- package/dist/deep-config.d.ts.map +1 -1
- package/dist/deep-config.js +7 -23
- package/dist/deep-config.js.map +1 -1
- package/dist/deep-progress.d.ts +2 -1
- package/dist/deep-progress.d.ts.map +1 -1
- package/dist/deep-progress.js +32 -47
- package/dist/deep-progress.js.map +1 -1
- package/dist/deep-scan.d.ts +20 -0
- package/dist/deep-scan.d.ts.map +1 -0
- package/dist/deep-scan.js +113 -0
- package/dist/deep-scan.js.map +1 -0
- package/dist/errors.d.ts +5 -2
- package/dist/errors.d.ts.map +1 -1
- package/dist/errors.js +7 -7
- package/dist/errors.js.map +1 -1
- package/dist/feedback.d.ts.map +1 -1
- package/dist/feedback.js +53 -21
- package/dist/feedback.js.map +1 -1
- package/dist/finding-catalogue.d.ts.map +1 -1
- package/dist/finding-catalogue.js +26 -30
- package/dist/finding-catalogue.js.map +1 -1
- package/dist/finding-normalization.d.ts +5 -0
- package/dist/finding-normalization.d.ts.map +1 -0
- package/dist/finding-normalization.js +120 -0
- package/dist/finding-normalization.js.map +1 -0
- package/dist/finding-retrieval.d.ts +9 -0
- package/dist/finding-retrieval.d.ts.map +1 -1
- package/dist/finding-retrieval.js.map +1 -1
- package/dist/finding-workflow.d.ts +13 -8
- package/dist/finding-workflow.d.ts.map +1 -1
- package/dist/finding-workflow.js +18 -13
- package/dist/finding-workflow.js.map +1 -1
- package/dist/findings-client.d.ts +2 -1
- package/dist/findings-client.d.ts.map +1 -1
- package/dist/findings-client.js +36 -9
- package/dist/findings-client.js.map +1 -1
- package/dist/findings-errors.d.ts +16 -0
- package/dist/findings-errors.d.ts.map +1 -0
- package/dist/findings-errors.js +24 -0
- package/dist/findings-errors.js.map +1 -0
- package/dist/findings-import.d.ts +1 -1
- package/dist/findings-import.d.ts.map +1 -1
- package/dist/findings-import.js +16 -44
- package/dist/findings-import.js.map +1 -1
- package/dist/github.d.ts.map +1 -1
- package/dist/github.js +9 -4
- package/dist/github.js.map +1 -1
- package/dist/import-scan.d.ts.map +1 -1
- package/dist/import-scan.js +49 -39
- package/dist/import-scan.js.map +1 -1
- package/dist/index.d.ts +11 -5
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -1
- package/dist/index.js.map +1 -1
- package/dist/knowledge-base.d.ts +7 -1
- package/dist/knowledge-base.d.ts.map +1 -1
- package/dist/knowledge-base.js +115 -47
- package/dist/knowledge-base.js.map +1 -1
- package/dist/linear.d.ts.map +1 -1
- package/dist/linear.js +4 -10
- package/dist/linear.js.map +1 -1
- package/dist/mock-scan.d.ts.map +1 -1
- package/dist/mock-scan.js +0 -1
- package/dist/mock-scan.js.map +1 -1
- package/dist/models.d.ts +24 -2
- package/dist/models.d.ts.map +1 -1
- package/dist/models.js.map +1 -1
- package/dist/multiscan.d.ts +9 -3
- package/dist/multiscan.d.ts.map +1 -1
- package/dist/multiscan.js +225 -153
- package/dist/multiscan.js.map +1 -1
- package/dist/owner-evidence.d.ts +10 -2
- package/dist/owner-evidence.d.ts.map +1 -1
- package/dist/owner-evidence.js +69 -14
- package/dist/owner-evidence.js.map +1 -1
- package/dist/patch-tui.d.ts.map +1 -1
- package/dist/patch-tui.js +5 -6
- package/dist/patch-tui.js.map +1 -1
- package/dist/project-config-schema.d.ts +10 -0
- package/dist/project-config-schema.d.ts.map +1 -1
- package/dist/project-config-schema.js +1 -0
- package/dist/project-config-schema.js.map +1 -1
- package/dist/project-config.d.ts +1 -0
- package/dist/project-config.d.ts.map +1 -1
- package/dist/project-config.js +5 -3
- package/dist/project-config.js.map +1 -1
- package/dist/prompt-files.d.ts +0 -1
- package/dist/prompt-files.d.ts.map +1 -1
- package/dist/prompt-files.js +2 -4
- package/dist/prompt-files.js.map +1 -1
- package/dist/provider-profile.d.ts +21 -0
- package/dist/provider-profile.d.ts.map +1 -0
- package/dist/provider-profile.js +133 -0
- package/dist/provider-profile.js.map +1 -0
- package/dist/publication-events.d.ts +6 -8
- package/dist/publication-events.d.ts.map +1 -1
- package/dist/publication-events.js +40 -79
- package/dist/publication-events.js.map +1 -1
- package/dist/publication-store.d.ts.map +1 -1
- package/dist/publication-store.js +48 -76
- package/dist/publication-store.js.map +1 -1
- package/dist/publication.d.ts +1 -2
- package/dist/publication.d.ts.map +1 -1
- package/dist/publication.js +7 -16
- package/dist/publication.js.map +1 -1
- package/dist/publish.d.ts +1 -5
- package/dist/publish.d.ts.map +1 -1
- package/dist/publish.js +138 -199
- package/dist/publish.js.map +1 -1
- package/dist/record.d.ts +2 -0
- package/dist/record.d.ts.map +1 -0
- package/dist/record.js +4 -0
- package/dist/record.js.map +1 -0
- package/dist/request-metadata.d.ts +9 -0
- package/dist/request-metadata.d.ts.map +1 -0
- package/dist/request-metadata.js +13 -0
- package/dist/request-metadata.js.map +1 -0
- package/dist/result.d.ts +4 -1
- package/dist/result.d.ts.map +1 -1
- package/dist/result.js +7 -0
- package/dist/result.js.map +1 -1
- package/dist/runtime.d.ts +25 -17
- package/dist/runtime.d.ts.map +1 -1
- package/dist/runtime.js +619 -255
- package/dist/runtime.js.map +1 -1
- package/dist/saved-scan-bootstrap.d.ts +14 -0
- package/dist/saved-scan-bootstrap.d.ts.map +1 -0
- package/dist/saved-scan-bootstrap.js +261 -0
- package/dist/saved-scan-bootstrap.js.map +1 -0
- package/dist/saved-scan.d.ts +1 -1
- package/dist/saved-scan.d.ts.map +1 -1
- package/dist/saved-scan.js +16 -32
- package/dist/saved-scan.js.map +1 -1
- package/dist/scan-activity.d.ts.map +1 -1
- package/dist/scan-activity.js +19 -30
- package/dist/scan-activity.js.map +1 -1
- package/dist/scan-comparison.d.ts +31 -18
- package/dist/scan-comparison.d.ts.map +1 -1
- package/dist/scan-comparison.js +307 -347
- package/dist/scan-comparison.js.map +1 -1
- package/dist/scan-dashboard.d.ts +3 -1
- package/dist/scan-dashboard.d.ts.map +1 -1
- package/dist/scan-dashboard.js +351 -92
- package/dist/scan-dashboard.js.map +1 -1
- package/dist/scan-history-renderer.d.ts.map +1 -1
- package/dist/scan-history-renderer.js +55 -15
- package/dist/scan-history-renderer.js.map +1 -1
- package/dist/scan-inputs.d.ts +6 -0
- package/dist/scan-inputs.d.ts.map +1 -0
- package/dist/scan-inputs.js +71 -0
- package/dist/scan-inputs.js.map +1 -0
- package/dist/scan-logs.d.ts +2 -3
- package/dist/scan-logs.d.ts.map +1 -1
- package/dist/scan-logs.js +14 -12
- package/dist/scan-logs.js.map +1 -1
- package/dist/scan-sessions.d.ts +4 -0
- package/dist/scan-sessions.d.ts.map +1 -1
- package/dist/scan-sessions.js +18 -3
- package/dist/scan-sessions.js.map +1 -1
- package/dist/scan-settings.d.ts +5 -0
- package/dist/scan-settings.d.ts.map +1 -1
- package/dist/scan-settings.js +4 -0
- package/dist/scan-settings.js.map +1 -1
- package/dist/scan-skill-paths.d.ts +8 -0
- package/dist/scan-skill-paths.d.ts.map +1 -0
- package/dist/scan-skill-paths.js +47 -0
- package/dist/scan-skill-paths.js.map +1 -0
- package/dist/security-policy-cli.d.ts.map +1 -1
- package/dist/security-policy-cli.js +15 -33
- package/dist/security-policy-cli.js.map +1 -1
- package/dist/security-policy.d.ts +17 -9
- package/dist/security-policy.d.ts.map +1 -1
- package/dist/security-policy.js +131 -98
- package/dist/security-policy.js.map +1 -1
- package/dist/server/api.d.ts +0 -1
- package/dist/server/api.d.ts.map +1 -1
- package/dist/server/api.js +0 -1
- package/dist/server/api.js.map +1 -1
- package/dist/server/embeddings.d.ts +3 -1
- package/dist/server/embeddings.d.ts.map +1 -1
- package/dist/server/embeddings.js +11 -3
- package/dist/server/embeddings.js.map +1 -1
- package/dist/server/errors.d.ts +5 -2
- package/dist/server/errors.d.ts.map +1 -1
- package/dist/server/errors.js +7 -0
- package/dist/server/errors.js.map +1 -1
- package/dist/server/sqlite-store.d.ts +0 -2
- package/dist/server/sqlite-store.d.ts.map +1 -1
- package/dist/server/sqlite-store.js +55 -55
- package/dist/server/sqlite-store.js.map +1 -1
- package/dist/server/storage.d.ts +0 -2
- package/dist/server/storage.d.ts.map +1 -1
- package/dist/server/storage.js.map +1 -1
- package/dist/severity-store.js +20 -32
- package/dist/severity-store.js.map +1 -1
- package/dist/standalone-validation-prompt.d.ts +2 -0
- package/dist/standalone-validation-prompt.d.ts.map +1 -0
- package/dist/standalone-validation-prompt.js +10 -0
- package/dist/standalone-validation-prompt.js.map +1 -0
- package/dist/suggest-owners.d.ts +6 -5
- package/dist/suggest-owners.d.ts.map +1 -1
- package/dist/suggest-owners.js +15 -10
- package/dist/suggest-owners.js.map +1 -1
- package/dist/targets.d.ts +12 -0
- package/dist/targets.d.ts.map +1 -1
- package/dist/targets.js +124 -62
- package/dist/targets.js.map +1 -1
- package/dist/trusted-executable.d.ts +6 -1
- package/dist/trusted-executable.d.ts.map +1 -1
- package/dist/trusted-executable.js +28 -9
- package/dist/trusted-executable.js.map +1 -1
- package/dist/value.d.ts +2 -0
- package/dist/value.d.ts.map +1 -0
- package/dist/value.js +27 -0
- package/dist/value.js.map +1 -0
- package/dist/version.d.ts.map +1 -1
- package/dist/version.js +3 -6
- package/dist/version.js.map +1 -1
- package/dist/windows-path.d.ts.map +1 -1
- package/dist/windows-path.js +1 -2
- package/dist/windows-path.js.map +1 -1
- package/dist/workbench-arguments.d.ts +3 -0
- package/dist/workbench-arguments.d.ts.map +1 -0
- package/dist/workbench-arguments.js +15 -0
- package/dist/workbench-arguments.js.map +1 -0
- package/dist/worker-progress.d.ts +2 -0
- package/dist/worker-progress.d.ts.map +1 -1
- package/dist/worker-progress.js +40 -46
- package/dist/worker-progress.js.map +1 -1
- package/docs/cli.md +1778 -0
- package/docs/dedupe-records.md +24 -0
- package/docs/findings-service.md +402 -0
- package/package.json +23 -23
- package/schemas/project-config.schema.json +5 -0
- package/_bundled_plugin/schemas/tools/worker-threat-model.schema.json +0 -18
- package/_bundled_plugin/scripts/normalize_candidates.py +0 -338
- package/_bundled_plugin/scripts/workbench_dashboard.py +0 -159
- package/_bundled_plugin/scripts/workbench_findings.py +0 -221
- package/_bundled_plugin/scripts/workbench_severity.py +0 -119
- package/_bundled_plugin/skills/assess-patch-risk/scripts/validate_patch_risk_assessment.py +0 -163
- package/dist/server/dashboard/THIRD_PARTY_NOTICES.txt +0 -276
- package/dist/server/dashboard/app.css +0 -2
- package/dist/server/dashboard/app.js +0 -66
- package/dist/server/dashboard/index.html +0 -18
- package/dist/server/dashboard-types.d.ts +0 -48
- package/dist/server/dashboard-types.d.ts.map +0 -1
- package/dist/server/dashboard-types.js +0 -2
- package/dist/server/dashboard-types.js.map +0 -1
- package/dist/server/dashboard.d.ts +0 -6
- package/dist/server/dashboard.d.ts.map +0 -1
- package/dist/server/dashboard.js +0 -59
- package/dist/server/dashboard.js.map +0 -1
- package/dist/server/findings-service.d.ts +0 -20
- package/dist/server/findings-service.d.ts.map +0 -1
- package/dist/server/findings-service.js +0 -31
- package/dist/server/findings-service.js.map +0 -1
- package/dist/server/index.d.ts +0 -2
- package/dist/server/index.d.ts.map +0 -1
- package/dist/server/index.js +0 -6
- package/dist/server/index.js.map +0 -1
- package/dist/server/routes.d.ts +0 -6
- package/dist/server/routes.d.ts.map +0 -1
- package/dist/server/routes.js +0 -86
- package/dist/server/routes.js.map +0 -1
- package/dist/server/serve.d.ts +0 -2
- package/dist/server/serve.d.ts.map +0 -1
- package/dist/server/serve.js +0 -28
- package/dist/server/serve.js.map +0 -1
- package/dist/server/server.d.ts +0 -10
- package/dist/server/server.d.ts.map +0 -1
- package/dist/server/server.js +0 -17
- package/dist/server/server.js.map +0 -1
- package/dist/server/validation.d.ts +0 -17
- package/dist/server/validation.d.ts.map +0 -1
- package/dist/server/validation.js +0 -53
- package/dist/server/validation.js.map +0 -1
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"security-policy.d.ts","sourceRoot":"","sources":["../src/security-policy.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"security-policy.d.ts","sourceRoot":"","sources":["../src/security-policy.ts"],"names":[],"mappings":"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"}
|
package/dist/security-policy.js
CHANGED
|
@@ -1,14 +1,17 @@
|
|
|
1
|
+
import { workbenchArgs } from "./workbench-arguments.js";
|
|
1
2
|
import { execFile } from "node:child_process";
|
|
2
|
-
import {
|
|
3
|
+
import { randomUUID } from "node:crypto";
|
|
4
|
+
import { sha256Text as digest } from "./contract.js";
|
|
3
5
|
import { constants } from "node:fs";
|
|
4
|
-
import { lstat, open, readdir, readFile, readlink, realpath, stat, } from "node:fs/promises";
|
|
6
|
+
import { lstat, open, readdir, readFile, readlink, realpath, rename, rm, stat, } from "node:fs/promises";
|
|
5
7
|
import { basename, dirname, isAbsolute, join, relative, resolve, sep, } from "node:path";
|
|
6
8
|
import { promisify } from "node:util";
|
|
7
|
-
import { z } from "
|
|
9
|
+
import { z } from "zod";
|
|
8
10
|
import { jsonForPrompt } from "./codex-prompt.js";
|
|
11
|
+
import { writeThreatModel } from "./artifact-export.js";
|
|
9
12
|
import { CodexSecurityError, InvalidTargetError } from "./errors.js";
|
|
10
13
|
import { resolvePluginPython } from "./runtime.js";
|
|
11
|
-
import { abortable, enclosingGitWorktreeRoot, enclosingGitWorktreeRoots, gitMetadataDirectories, gitObjectDirectories, isGitMetadataDirectory, normalizeRepository, normalizeTarget, relativePathIsOutside, } from "./targets.js";
|
|
14
|
+
import { nullIfMissingFile, nullIfMissingPath, abortable, enclosingGitWorktreeRoot, enclosingGitWorktreeRoots, gitMetadataDirectories, gitObjectDirectories, isGitMetadataDirectory, normalizeRepository, normalizeTarget, relativePathIsOutside, } from "./targets.js";
|
|
12
15
|
const securityPolicyRepositoryBindings = new WeakMap();
|
|
13
16
|
export async function requireSecurityPolicyRepositoryBinding(target, signal) {
|
|
14
17
|
const binding = securityPolicyRepositoryBindings.get(target);
|
|
@@ -31,14 +34,12 @@ export async function securityPolicyProtectedRoots(target, signal) {
|
|
|
31
34
|
const metadata = await Promise.all(roots.map((root) => gitMetadataDirectories(root, signal)));
|
|
32
35
|
return [...new Set([roots.at(-1) ?? target.repository, ...metadata.flat()])];
|
|
33
36
|
}
|
|
34
|
-
const securityPolicyStageSchema = z
|
|
35
|
-
.object({
|
|
37
|
+
const securityPolicyStageSchema = z.strictObject({
|
|
36
38
|
markdown: z.string(),
|
|
37
39
|
questions: z.array(z.string()),
|
|
38
40
|
reviewNotes: z.array(z.string()),
|
|
39
41
|
blockedReason: z.string().nullable(),
|
|
40
|
-
})
|
|
41
|
-
.strict();
|
|
42
|
+
});
|
|
42
43
|
export function securityPolicyStageOutputSchema() {
|
|
43
44
|
return z.toJSONSchema(securityPolicyStageSchema, {
|
|
44
45
|
target: "draft-7",
|
|
@@ -90,11 +91,7 @@ export async function resolveSecurityPolicyTarget(repository, path = ".", signal
|
|
|
90
91
|
return target;
|
|
91
92
|
}
|
|
92
93
|
export async function readSecurityPolicy(path) {
|
|
93
|
-
const metadata = await lstat(path).catch(
|
|
94
|
-
if (error.code === "ENOENT")
|
|
95
|
-
return null;
|
|
96
|
-
throw error;
|
|
97
|
-
});
|
|
94
|
+
const metadata = await lstat(path).catch(nullIfMissingFile);
|
|
98
95
|
if (metadata === null)
|
|
99
96
|
return null;
|
|
100
97
|
if (!metadata.isFile()) {
|
|
@@ -132,22 +129,14 @@ async function readPolicyFile(path, options = {}) {
|
|
|
132
129
|
export async function readSecurityPolicySnapshot(target, signal, gitMetadataPaths = []) {
|
|
133
130
|
await requirePolicyOutsideGitMetadata(target.targetPath, signal, gitMetadataPaths);
|
|
134
131
|
const previousContent = await readSecurityPolicy(target.targetPath);
|
|
135
|
-
const canonicalTarget = await realpath(target.targetPath).catch(
|
|
136
|
-
if (error.code === "ENOENT")
|
|
137
|
-
return null;
|
|
138
|
-
throw error;
|
|
139
|
-
});
|
|
132
|
+
const canonicalTarget = await realpath(target.targetPath).catch(nullIfMissingFile);
|
|
140
133
|
const inherited = [];
|
|
141
134
|
let directory = target.repository;
|
|
142
135
|
for (const part of target.scope === "." ? [] : target.scope.split("/")) {
|
|
143
136
|
signal?.throwIfAborted();
|
|
144
137
|
const path = join(directory, "SECURITY.md");
|
|
145
138
|
const policyPath = relative(target.repository, path).split(sep).join("/");
|
|
146
|
-
let metadata = await lstat(path).catch(
|
|
147
|
-
if (error.code === "ENOENT" || error.code === "ENOTDIR")
|
|
148
|
-
return null;
|
|
149
|
-
throw error;
|
|
150
|
-
});
|
|
139
|
+
let metadata = await lstat(path).catch(nullIfMissingPath);
|
|
151
140
|
if (metadata?.isSymbolicLink()) {
|
|
152
141
|
const alias = await policyLinkSnapshot(path, target.repository, signal, gitMetadataPaths);
|
|
153
142
|
if (alias.status === "cycle") {
|
|
@@ -159,11 +148,7 @@ export async function readSecurityPolicySnapshot(target, signal, gitMetadataPath
|
|
|
159
148
|
throw new CodexSecurityError(`SECURITY.md ${JSON.stringify(policyPath)} points to the selected policy and would change guidance outside the selected component. Fix the link before drafting a policy.`);
|
|
160
149
|
const links = { links: alias.links, destination: alias.destination };
|
|
161
150
|
inherited.push([policyPath, `link:${digest(JSON.stringify(links))}`]);
|
|
162
|
-
metadata = await stat(path).catch(
|
|
163
|
-
if (error.code === "ENOENT" || error.code === "ENOTDIR")
|
|
164
|
-
return null;
|
|
165
|
-
throw error;
|
|
166
|
-
});
|
|
151
|
+
metadata = await stat(path).catch(nullIfMissingPath);
|
|
167
152
|
}
|
|
168
153
|
if (metadata?.isFile()) {
|
|
169
154
|
const normalized = await normalizeTarget(target.repository, [path], signal);
|
|
@@ -204,11 +189,7 @@ async function policyLinkSnapshot(path, repository, signal, gitMetadataPaths = [
|
|
|
204
189
|
const relativePath = policyRelativePath(repository, canonical);
|
|
205
190
|
if (!(await stat(parent)).isDirectory())
|
|
206
191
|
return { links, destination: null, status: "missing" };
|
|
207
|
-
const metadata = await lstat(canonical).catch(
|
|
208
|
-
if (error.code === "ENOENT" || error.code === "ENOTDIR")
|
|
209
|
-
return null;
|
|
210
|
-
throw error;
|
|
211
|
-
});
|
|
192
|
+
const metadata = await lstat(canonical).catch(nullIfMissingPath);
|
|
212
193
|
if (metadata !== null || links.length > 0)
|
|
213
194
|
await requirePolicyOutsideGitMetadata(canonical, signal, gitMetadataPaths);
|
|
214
195
|
if (!metadata?.isSymbolicLink())
|
|
@@ -262,13 +243,8 @@ async function securityPolicyPaths(root, repository, signal) {
|
|
|
262
243
|
}
|
|
263
244
|
for (const name of [".github", "docs"]) {
|
|
264
245
|
let directory = join(repository, name);
|
|
265
|
-
const metadata = await lstat(directory).catch((error) => {
|
|
266
|
-
if (error.code === "ENOENT" || error.code === "ENOTDIR")
|
|
267
|
-
return null;
|
|
268
|
-
throw error;
|
|
269
|
-
});
|
|
270
246
|
// Keep directory links distinct from their destinations.
|
|
271
|
-
if (
|
|
247
|
+
if ((await lstat(directory).catch(nullIfMissingPath))?.isDirectory()) {
|
|
272
248
|
directory = await realpath(directory);
|
|
273
249
|
policyRelativePath(repository, directory);
|
|
274
250
|
}
|
|
@@ -285,30 +261,18 @@ async function securityPolicyPaths(root, repository, signal) {
|
|
|
285
261
|
const entries = await readdir(directory, { withFileTypes: true });
|
|
286
262
|
if (await isGitMetadataDirectory(directory, signal)) {
|
|
287
263
|
gitDirectories.add(directory);
|
|
288
|
-
const common = await readFile(join(directory, "commondir"), "utf8").catch(
|
|
289
|
-
if (error.code === "ENOENT")
|
|
290
|
-
return null;
|
|
291
|
-
throw error;
|
|
292
|
-
});
|
|
264
|
+
const common = await readFile(join(directory, "commondir"), "utf8").catch(nullIfMissingFile);
|
|
293
265
|
if (common !== null)
|
|
294
266
|
gitDirectories.add(await realpath(resolve(directory, common.replace(/[\r\n]+$/u, ""))));
|
|
295
267
|
continue;
|
|
296
268
|
}
|
|
297
269
|
if (!knownRoots.has(directory) &&
|
|
298
270
|
entries.some((entry) => entry.name.toLowerCase() === ".git") &&
|
|
299
|
-
(await lstat(join(directory, ".git")).catch(
|
|
300
|
-
if (error.code === "ENOENT")
|
|
301
|
-
return null;
|
|
302
|
-
throw error;
|
|
303
|
-
})) !== null) {
|
|
271
|
+
(await lstat(join(directory, ".git")).catch(nullIfMissingFile)) !== null) {
|
|
304
272
|
await addRoot(directory);
|
|
305
273
|
}
|
|
306
274
|
const path = join(directory, "SECURITY.md");
|
|
307
|
-
const metadata = await lstat(path).catch(
|
|
308
|
-
if (error.code === "ENOENT" || error.code === "ENOTDIR")
|
|
309
|
-
return null;
|
|
310
|
-
throw error;
|
|
311
|
-
});
|
|
275
|
+
const metadata = await lstat(path).catch(nullIfMissingPath);
|
|
312
276
|
if ((metadata?.isFile() || metadata?.isSymbolicLink()) &&
|
|
313
277
|
!reportingPaths.has(path))
|
|
314
278
|
policies.push(path);
|
|
@@ -317,11 +281,7 @@ async function securityPolicyPaths(root, repository, signal) {
|
|
|
317
281
|
if (!entry.isDirectory() || entry.name === ".git")
|
|
318
282
|
continue;
|
|
319
283
|
if (entry.name.toLowerCase() === ".git") {
|
|
320
|
-
const metadata = await realpath(join(directory, ".git")).catch(
|
|
321
|
-
if (error.code === "ENOENT")
|
|
322
|
-
return null;
|
|
323
|
-
throw error;
|
|
324
|
-
});
|
|
284
|
+
const metadata = await realpath(join(directory, ".git")).catch(nullIfMissingFile);
|
|
325
285
|
if (metadata !== null &&
|
|
326
286
|
relative(metadata, join(directory, entry.name)) === "")
|
|
327
287
|
continue;
|
|
@@ -404,11 +364,7 @@ async function requirePolicyOutsideGitMetadata(path, signal, gitMetadataPaths =
|
|
|
404
364
|
if (root === null || relative(root, parent) !== "")
|
|
405
365
|
return;
|
|
406
366
|
const marker = await lstat(join(root, ".git"));
|
|
407
|
-
const candidate = await lstat(path).catch(
|
|
408
|
-
if (error.code === "ENOENT")
|
|
409
|
-
return null;
|
|
410
|
-
throw error;
|
|
411
|
-
});
|
|
367
|
+
const candidate = await lstat(path).catch(nullIfMissingFile);
|
|
412
368
|
if (candidate !== null &&
|
|
413
369
|
candidate.dev === marker.dev &&
|
|
414
370
|
candidate.ino === marker.ino)
|
|
@@ -433,13 +389,11 @@ export async function requireUnchangedSecurityPolicy(target, snapshot, signal, g
|
|
|
433
389
|
export async function resolveSecurityPolicyGuidance(target, pluginRoot, environment, signal, policyPaths = [], gitMetadataPaths = []) {
|
|
434
390
|
const { stdout } = await execFileAsync(process.execPath, [
|
|
435
391
|
join(pluginRoot, "mcp", "helpers.mjs"),
|
|
436
|
-
"resolve-security-md",
|
|
437
|
-
|
|
438
|
-
|
|
439
|
-
|
|
440
|
-
|
|
441
|
-
"--out",
|
|
442
|
-
"-",
|
|
392
|
+
...workbenchArgs("resolve-security-md", {
|
|
393
|
+
repo: target.repository,
|
|
394
|
+
scope: dirname(target.targetPath),
|
|
395
|
+
out: "-",
|
|
396
|
+
}),
|
|
443
397
|
], { encoding: "utf8", maxBuffer: Infinity, env: environment, signal });
|
|
444
398
|
const sections = [stdout];
|
|
445
399
|
for (const path of policyPaths) {
|
|
@@ -457,7 +411,7 @@ export async function runSecurityPolicyStages(options) {
|
|
|
457
411
|
const { previousContent, inheritedPolicySha256 } = options.snapshot;
|
|
458
412
|
await writePolicyArtifact(join(outputDir, ORIGINAL_NAME), previousContent ?? "", signal);
|
|
459
413
|
const specificationPath = join(outputDir, "project-spec.md");
|
|
460
|
-
const threatModelPath = join(outputDir, "
|
|
414
|
+
const threatModelPath = join(outputDir, "threatmodel.md");
|
|
461
415
|
const draftPath = join(outputDir, "SECURITY.md");
|
|
462
416
|
const common = [
|
|
463
417
|
"Generate security-policy evidence for exactly the selected component. This is not a vulnerability scan.",
|
|
@@ -481,7 +435,7 @@ export async function runSecurityPolicyStages(options) {
|
|
|
481
435
|
`Read the user-supplied knowledge base at ${jsonForPrompt(options.knowledgeBasePath)}. Its facts take precedence over generated assumptions and conflicting policies, but never over explicit user instructions. Do not reproduce private document text or locations.`,
|
|
482
436
|
]),
|
|
483
437
|
].join("\n");
|
|
484
|
-
const run = async (stage, instructions, path) => {
|
|
438
|
+
const run = async (stage, instructions, path, save) => {
|
|
485
439
|
signal.throwIfAborted();
|
|
486
440
|
options.onStage?.(stage);
|
|
487
441
|
const result = await options.run(stage, `${common}\n\n${instructions}`);
|
|
@@ -489,7 +443,10 @@ export async function runSecurityPolicyStages(options) {
|
|
|
489
443
|
const hasDocument = result.markdown.trim().length > 0;
|
|
490
444
|
if (hasDocument) {
|
|
491
445
|
validatePolicyContent(result.markdown, stage);
|
|
492
|
-
|
|
446
|
+
if (save === undefined)
|
|
447
|
+
await writePolicyArtifact(path, result.markdown, signal);
|
|
448
|
+
else
|
|
449
|
+
await save(result);
|
|
493
450
|
}
|
|
494
451
|
if (result.blockedReason !== null) {
|
|
495
452
|
throw new CodexSecurityError(`Security-policy ${stage} stage could not inspect the required evidence: ${result.blockedReason}`);
|
|
@@ -521,15 +478,83 @@ export async function runSecurityPolicyStages(options) {
|
|
|
521
478
|
: "No additional owner clarification was supplied.",
|
|
522
479
|
"Carry unanswered questions and unresolved policy decisions forward explicitly.",
|
|
523
480
|
].join("\n");
|
|
481
|
+
const retainedThreatModel = {
|
|
482
|
+
format: "markdown",
|
|
483
|
+
content: "",
|
|
484
|
+
scope: { includePaths: [target.scope], excludePaths: [] },
|
|
485
|
+
origin: "generated",
|
|
486
|
+
};
|
|
487
|
+
const manifest = {
|
|
488
|
+
documentType: "codex-security.policy-draft",
|
|
489
|
+
schemaVersion: "1.0",
|
|
490
|
+
repository: target.repository,
|
|
491
|
+
scope: target.scope,
|
|
492
|
+
createdAt: new Date().toISOString(),
|
|
493
|
+
revision: options.revision,
|
|
494
|
+
previousPolicySha256: previousContent === null ? null : digest(previousContent),
|
|
495
|
+
inheritedPolicySha256,
|
|
496
|
+
model: options.model,
|
|
497
|
+
reasoningEffort: options.reasoningEffort,
|
|
498
|
+
pluginVersion: options.pluginVersion,
|
|
499
|
+
customPlugin: options.pluginPath !== undefined,
|
|
500
|
+
status: "threat_model_ready",
|
|
501
|
+
threatModel: retainedThreatModel,
|
|
502
|
+
reviewNotes: [],
|
|
503
|
+
};
|
|
504
|
+
const saveManifest = async () => {
|
|
505
|
+
const temporary = join(outputDir, `.policy-draft-${randomUUID()}.json`);
|
|
506
|
+
try {
|
|
507
|
+
await writePolicyArtifact(temporary, `${JSON.stringify(manifest, null, 2)}\n`, signal);
|
|
508
|
+
await rename(temporary, join(outputDir, MANIFEST_NAME));
|
|
509
|
+
}
|
|
510
|
+
finally {
|
|
511
|
+
await rm(temporary, { force: true }).catch(() => undefined);
|
|
512
|
+
}
|
|
513
|
+
};
|
|
514
|
+
const saveModelDocument = async () => {
|
|
515
|
+
let warning;
|
|
516
|
+
try {
|
|
517
|
+
warning = await writeThreatModel(outputDir, {
|
|
518
|
+
pluginRoot: options.pluginRoot,
|
|
519
|
+
pythonPath: options.pythonPath,
|
|
520
|
+
protectedRoot: options.protectedRoot,
|
|
521
|
+
signal,
|
|
522
|
+
});
|
|
523
|
+
}
|
|
524
|
+
catch (error) {
|
|
525
|
+
signal.throwIfAborted();
|
|
526
|
+
warning = `Could not save threatmodel.md; the retained threat model remains exportable: ${error instanceof Error ? error.message : String(error)}`;
|
|
527
|
+
}
|
|
528
|
+
if (warning) {
|
|
529
|
+
try {
|
|
530
|
+
options.onWarning?.(warning);
|
|
531
|
+
}
|
|
532
|
+
catch { }
|
|
533
|
+
}
|
|
534
|
+
signal.throwIfAborted();
|
|
535
|
+
return warning ? null : threatModelPath;
|
|
536
|
+
};
|
|
524
537
|
const threatModel = await run("threat_model", [
|
|
525
538
|
`Read the completed project specification at ${jsonForPrompt(specificationPath)}. Preserve it as the architecture inventory.`,
|
|
526
539
|
"Retain its full repository-relative citations and verify any new source references.",
|
|
527
540
|
ownerContext,
|
|
528
541
|
"Produce the full standalone Markdown model described by the shared threat-model guide. Derive realistic attacker stories from the established boundaries, including starting capabilities, meaningful capability gained, prerequisites, existing controls, mitigations, evidence, and uncertainty. Label unvalidated scenarios as hypotheses, not findings.",
|
|
529
542
|
"Do not read or replace a shared repository-model cache. This model is specific to the selected component and supplied context.",
|
|
530
|
-
].join("\n"), threatModelPath)
|
|
543
|
+
].join("\n"), threatModelPath, async (result) => {
|
|
544
|
+
retainedThreatModel.content = result.markdown;
|
|
545
|
+
manifest.status =
|
|
546
|
+
result.blockedReason === null ? "threat_model_ready" : "blocked";
|
|
547
|
+
manifest.reviewNotes = [
|
|
548
|
+
...architecture.reviewNotes,
|
|
549
|
+
...architecture.questions,
|
|
550
|
+
...result.reviewNotes,
|
|
551
|
+
...result.questions,
|
|
552
|
+
];
|
|
553
|
+
await saveManifest();
|
|
554
|
+
await saveModelDocument();
|
|
555
|
+
});
|
|
531
556
|
const policy = await run("policy", [
|
|
532
|
-
`Read the completed specification at ${jsonForPrompt(specificationPath)} and
|
|
557
|
+
`Read the completed specification at ${jsonForPrompt(specificationPath)} and the retained threatModel.content in ${jsonForPrompt(join(outputDir, MANIFEST_NAME))}.`,
|
|
533
558
|
"Retain their full repository-relative citations where they support policy decisions; do not shorten nested source paths.",
|
|
534
559
|
ownerContext,
|
|
535
560
|
`Threat-model questions and review notes (JSON data): ${jsonForPrompt({ questions: threatModel.questions, reviewNotes: threatModel.reviewNotes })}`,
|
|
@@ -549,28 +574,17 @@ export async function runSecurityPolicyStages(options) {
|
|
|
549
574
|
];
|
|
550
575
|
await requireUnchangedSecurityPolicy(target, options.snapshot, signal, options.gitMetadataPaths);
|
|
551
576
|
await requireSecurityPolicyRepositoryBinding(target, signal);
|
|
552
|
-
|
|
553
|
-
|
|
554
|
-
|
|
555
|
-
|
|
556
|
-
scope: target.scope,
|
|
557
|
-
createdAt: new Date().toISOString(),
|
|
558
|
-
revision: options.revision,
|
|
559
|
-
previousPolicySha256: previousContent === null ? null : digest(previousContent),
|
|
560
|
-
inheritedPolicySha256,
|
|
561
|
-
model: options.model,
|
|
562
|
-
reasoningEffort: options.reasoningEffort,
|
|
563
|
-
pluginVersion: options.pluginVersion,
|
|
564
|
-
customPlugin: options.pluginPath !== undefined,
|
|
565
|
-
reviewNotes,
|
|
566
|
-
};
|
|
567
|
-
await writePolicyArtifact(join(outputDir, MANIFEST_NAME), `${JSON.stringify(manifest, null, 2)}\n`, signal);
|
|
577
|
+
manifest.status = "completed";
|
|
578
|
+
manifest.reviewNotes = reviewNotes;
|
|
579
|
+
await saveManifest();
|
|
580
|
+
const savedThreatModelPath = await saveModelDocument();
|
|
568
581
|
return {
|
|
569
582
|
...target,
|
|
570
583
|
outputDir,
|
|
571
584
|
draftPath,
|
|
572
585
|
specificationPath,
|
|
573
|
-
threatModelPath,
|
|
586
|
+
threatModelPath: savedThreatModelPath,
|
|
587
|
+
threatModel: retainedThreatModel,
|
|
574
588
|
content: policy.markdown,
|
|
575
589
|
previousContent,
|
|
576
590
|
inheritedPolicySha256,
|
|
@@ -611,12 +625,34 @@ export async function securityPolicyDiff(draft, python, signal) {
|
|
|
611
625
|
" if not line.endswith('\\n'): sys.stdout.buffer.write(b'\\n\\\\\n')",
|
|
612
626
|
].join("\n");
|
|
613
627
|
const diff = await new Promise((resolve, reject) => {
|
|
628
|
+
let inputError;
|
|
614
629
|
const child = execFile(interpreter, ["-I", "-c", script], {
|
|
615
630
|
encoding: "utf8",
|
|
616
631
|
maxBuffer: Infinity,
|
|
617
632
|
signal,
|
|
618
|
-
}, (error, stdout) =>
|
|
619
|
-
|
|
633
|
+
}, (error, stdout) => {
|
|
634
|
+
const failure = error ?? inputError;
|
|
635
|
+
if (failure === undefined)
|
|
636
|
+
resolve(stdout);
|
|
637
|
+
else
|
|
638
|
+
reject(failure);
|
|
639
|
+
});
|
|
640
|
+
const releaseFailedInput = () => {
|
|
641
|
+
if (inputError === undefined)
|
|
642
|
+
return;
|
|
643
|
+
if (child.exitCode === null && child.signalCode === null) {
|
|
644
|
+
if (child.pid !== undefined)
|
|
645
|
+
reject(inputError);
|
|
646
|
+
return;
|
|
647
|
+
}
|
|
648
|
+
child.stdout.destroy();
|
|
649
|
+
child.stderr.destroy();
|
|
650
|
+
};
|
|
651
|
+
child.once("exit", releaseFailedInput);
|
|
652
|
+
child.stdin.on("error", (error) => {
|
|
653
|
+
inputError = error;
|
|
654
|
+
releaseFailedInput();
|
|
655
|
+
});
|
|
620
656
|
child.stdin.end(JSON.stringify([
|
|
621
657
|
draft.previousContent ?? "",
|
|
622
658
|
draft.content,
|
|
@@ -666,7 +702,4 @@ function diffLabel(path) {
|
|
|
666
702
|
return path;
|
|
667
703
|
return formatSecurityPolicyText(JSON.stringify(path));
|
|
668
704
|
}
|
|
669
|
-
function digest(value) {
|
|
670
|
-
return createHash("sha256").update(value).digest("hex");
|
|
671
|
-
}
|
|
672
705
|
//# sourceMappingURL=security-policy.js.map
|