@openai/codex-security 0.8.3 → 0.9.1
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 +192 -151
- package/_bundled_plugin/.mcp.json +5 -1
- package/_bundled_plugin/examples/completed-scan/findings.json +16 -4
- package/_bundled_plugin/examples/completed-scan/report.md +11 -8
- package/_bundled_plugin/examples/completed-scan/scan-manifest.json +4 -2
- package/_bundled_plugin/mcp/fzstd-LICENSE.txt +21 -0
- package/_bundled_plugin/mcp/helpers.mjs +2 -11
- package/_bundled_plugin/mcp/helpers.mjs.br +0 -0
- package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +3 -210
- 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/package.json +1 -0
- package/_bundled_plugin/mcp/permission-profile-preflight.mjs +5 -2
- package/_bundled_plugin/mcp/server.mjs +2 -11
- package/_bundled_plugin/mcp/server.mjs.br +0 -0
- package/_bundled_plugin/mcp/session-decompression.mjs +712 -0
- package/_bundled_plugin/references/default-severity-rubric.md +9 -4
- package/_bundled_plugin/references/final-report.md +5 -3
- package/_bundled_plugin/references/finding-detail-fields.md +18 -18
- package/_bundled_plugin/references/sarif-adapter.md +8 -2
- package/_bundled_plugin/references/scan-artifacts.md +21 -12
- package/_bundled_plugin/references/scan-contract.md +27 -33
- package/_bundled_plugin/schemas/tools/scan-draft.schema.json +2 -2
- package/_bundled_plugin/scripts/check_deep_scan_target.py +97 -0
- package/_bundled_plugin/scripts/codex_profile.mjs +7 -1
- package/_bundled_plugin/scripts/deep_scan_config.py +20 -1
- package/_bundled_plugin/scripts/deep_scan_workbench.py +165 -342
- package/_bundled_plugin/scripts/filesystem_identity.py +1 -0
- package/_bundled_plugin/scripts/finalize_scan_contract.py +153 -227
- package/_bundled_plugin/scripts/finding_preview.py +20 -0
- package/_bundled_plugin/scripts/launch_codex_security_mcp +1 -0
- package/_bundled_plugin/scripts/legacy_findings.py +148 -0
- package/_bundled_plugin/scripts/posix_scan_local_files.py +11 -0
- package/_bundled_plugin/scripts/read_codex_session.mjs +21 -0
- package/_bundled_plugin/scripts/report_projection.py +81 -43
- package/_bundled_plugin/scripts/review_state.py +8 -2
- package/_bundled_plugin/scripts/servicenow_avit.py +20 -0
- package/_bundled_plugin/scripts/snapshot_sqlite.py +1 -0
- package/_bundled_plugin/scripts/threat_model_projection.py +22 -26
- package/_bundled_plugin/scripts/validate_scan_contract.py +7 -1
- package/_bundled_plugin/scripts/windows_scan_local_files.py +388 -17
- package/_bundled_plugin/scripts/workbench/__init__.py +1 -1
- package/_bundled_plugin/scripts/workbench/handoff.py +47 -0
- package/_bundled_plugin/scripts/workbench/retained_coverage.py +30 -51
- package/_bundled_plugin/scripts/workbench/retained_records.py +18 -30
- package/_bundled_plugin/scripts/workbench/runtime_toml.py +4 -1
- package/_bundled_plugin/scripts/workbench/saved_coverage.py +9 -17
- package/_bundled_plugin/scripts/workbench/saved_outputs.py +9 -0
- package/_bundled_plugin/scripts/workbench/saved_sources.py +47 -40
- package/_bundled_plugin/scripts/workbench/storage.py +71 -7
- package/_bundled_plugin/scripts/workbench_cli.py +30 -12
- package/_bundled_plugin/scripts/workbench_constants.py +10 -0
- package/_bundled_plugin/scripts/workbench_coverage_receipts.py +3 -3
- package/_bundled_plugin/scripts/workbench_db.py +369 -137
- package/_bundled_plugin/scripts/workbench_feedback.py +8 -7
- package/_bundled_plugin/scripts/workbench_finding_index.py +1 -0
- package/_bundled_plugin/scripts/workbench_finding_workflows.py +4 -0
- package/_bundled_plugin/scripts/workbench_native_indexes.py +12 -12
- package/_bundled_plugin/scripts/workbench_progress.py +10 -1
- package/_bundled_plugin/scripts/workbench_publication.py +14 -10
- package/_bundled_plugin/scripts/workbench_remediation.py +13 -0
- package/_bundled_plugin/scripts/workbench_saved_results.py +132 -77
- package/_bundled_plugin/scripts/workbench_scan_history.py +117 -55
- package/_bundled_plugin/scripts/workbench_scan_start.py +83 -24
- package/_bundled_plugin/scripts/workbench_scan_usage.py +644 -68
- package/_bundled_plugin/scripts/workbench_schema.py +44 -55
- package/_bundled_plugin/scripts/workbench_setup.py +13 -1
- package/_bundled_plugin/scripts/workbench_source_excerpt.py +13 -0
- package/_bundled_plugin/scripts/workbench_source_scopes.py +18 -0
- package/_bundled_plugin/scripts/workbench_target.py +127 -56
- package/_bundled_plugin/scripts/workbench_target_state.py +3 -0
- package/_bundled_plugin/scripts/workbench_validation.py +43 -3
- package/_bundled_plugin/shared/workbench-history-repairs.json +19 -23
- package/_bundled_plugin/shared/workbench-migrations.json +34 -0
- package/_bundled_plugin/skills/cloud-findings/SKILL.md +5 -5
- package/_bundled_plugin/skills/deep-security-scan/SKILL.md +7 -50
- package/_bundled_plugin/skills/fix-finding/SKILL.md +1 -1
- package/_bundled_plugin/skills/publish-findings/SKILL.md +32 -25
- package/_bundled_plugin/skills/publish-findings/references/checkmarx-import.md +37 -0
- package/_bundled_plugin/skills/publish-findings/references/wiz-import.md +3 -3
- package/_bundled_plugin/skills/publish-findings/scripts/collect_checkmarx.py +464 -0
- package/_bundled_plugin/skills/threat-model-visualize/scripts/build_explorer.py +22 -1
- package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +6 -2
- package/dist/api.d.ts +39 -4
- package/dist/api.d.ts.map +1 -1
- package/dist/api.js +774 -292
- package/dist/api.js.map +1 -1
- package/dist/auth.d.ts.map +1 -1
- package/dist/auth.js +4 -6
- package/dist/auth.js.map +1 -1
- package/dist/bedrock-oss-pricing.d.ts +6 -0
- package/dist/bedrock-oss-pricing.d.ts.map +1 -0
- package/dist/bedrock-oss-pricing.js +58 -0
- package/dist/bedrock-oss-pricing.js.map +1 -0
- package/dist/bedrock-pricing.d.ts +15 -0
- package/dist/bedrock-pricing.d.ts.map +1 -0
- package/dist/bedrock-pricing.js +117 -0
- package/dist/bedrock-pricing.js.map +1 -0
- package/dist/blackduck-findings.d.ts.map +1 -1
- package/dist/blackduck-findings.js +35 -20
- package/dist/blackduck-findings.js.map +1 -1
- package/dist/bulk-scan-discovery.d.ts.map +1 -1
- package/dist/bulk-scan-discovery.js +4 -4
- package/dist/bulk-scan-discovery.js.map +1 -1
- package/dist/checkmarx-evidence.d.ts +19 -0
- package/dist/checkmarx-evidence.d.ts.map +1 -0
- package/dist/checkmarx-evidence.js +36 -0
- package/dist/checkmarx-evidence.js.map +1 -0
- package/dist/checkmarx-findings.d.ts +4 -0
- package/dist/checkmarx-findings.d.ts.map +1 -0
- package/dist/checkmarx-findings.js +27 -0
- package/dist/checkmarx-findings.js.map +1 -0
- package/dist/checkmarx-one.d.ts +4 -0
- package/dist/checkmarx-one.d.ts.map +1 -0
- package/dist/checkmarx-one.js +53 -0
- package/dist/checkmarx-one.js.map +1 -0
- package/dist/checkmarx-repository.d.ts +12 -0
- package/dist/checkmarx-repository.d.ts.map +1 -0
- package/dist/checkmarx-repository.js +181 -0
- package/dist/checkmarx-repository.js.map +1 -0
- package/dist/checkmarx-xml.d.ts +12 -0
- package/dist/checkmarx-xml.d.ts.map +1 -0
- package/dist/checkmarx-xml.js +196 -0
- package/dist/checkmarx-xml.js.map +1 -0
- package/dist/classify-severity-records.d.ts +1 -9
- package/dist/classify-severity-records.d.ts.map +1 -1
- package/dist/classify-severity-records.js +3 -13
- package/dist/classify-severity-records.js.map +1 -1
- package/dist/classify-severity.d.ts.map +1 -1
- package/dist/classify-severity.js +2 -4
- package/dist/classify-severity.js.map +1 -1
- package/dist/cli.d.ts +11 -5
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +1734 -1238
- package/dist/cli.js.map +1 -1
- package/dist/cloud-publish.js +2 -2
- package/dist/cloud-publish.js.map +1 -1
- package/dist/component-scan.d.ts +16 -3
- package/dist/component-scan.d.ts.map +1 -1
- package/dist/component-scan.js +27 -2
- package/dist/component-scan.js.map +1 -1
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +100 -66
- package/dist/config.js.map +1 -1
- package/dist/continuum-findings.d.ts.map +1 -1
- package/dist/continuum-findings.js +80 -12
- package/dist/continuum-findings.js.map +1 -1
- package/dist/contract-values.d.ts +2 -0
- package/dist/contract-values.d.ts.map +1 -1
- package/dist/contract-values.js +12 -9
- package/dist/contract-values.js.map +1 -1
- package/dist/cost-model.d.ts +13 -1
- package/dist/cost-model.d.ts.map +1 -1
- package/dist/cost-model.js +66 -112
- package/dist/cost-model.js.map +1 -1
- package/dist/cost.d.ts +42 -3
- package/dist/cost.d.ts.map +1 -1
- package/dist/cost.js +483 -104
- package/dist/cost.js.map +1 -1
- package/dist/custom-publish.d.ts +4 -0
- package/dist/custom-publish.d.ts.map +1 -1
- package/dist/custom-publish.js +40 -3
- package/dist/custom-publish.js.map +1 -1
- package/dist/deduplication/local.d.ts +2 -2
- package/dist/deduplication/local.d.ts.map +1 -1
- package/dist/deduplication/local.js +2 -2
- package/dist/deduplication/local.js.map +1 -1
- package/dist/deduplication/refusal.d.ts.map +1 -1
- package/dist/deduplication/refusal.js +25 -5
- package/dist/deduplication/refusal.js.map +1 -1
- package/dist/deduplication/scan.d.ts +3 -0
- package/dist/deduplication/scan.d.ts.map +1 -1
- package/dist/deduplication/scan.js +1 -1
- package/dist/deduplication/scan.js.map +1 -1
- package/dist/deep-config.d.ts +0 -1
- package/dist/deep-config.d.ts.map +1 -1
- package/dist/deep-config.js +22 -33
- package/dist/deep-config.js.map +1 -1
- package/dist/deep-scan-defaults.d.ts +2 -0
- package/dist/deep-scan-defaults.d.ts.map +1 -1
- package/dist/deep-scan-defaults.js +28 -1
- package/dist/deep-scan-defaults.js.map +1 -1
- package/dist/deep-scan.d.ts +2 -0
- package/dist/deep-scan.d.ts.map +1 -1
- package/dist/deep-scan.js +28 -4
- package/dist/deep-scan.js.map +1 -1
- package/dist/default-severity-rubric.d.ts +1 -1
- package/dist/default-severity-rubric.d.ts.map +1 -1
- package/dist/default-severity-rubric.js +1 -1
- package/dist/default-severity-rubric.js.map +1 -1
- package/dist/endor-findings.d.ts +3 -1
- package/dist/endor-findings.d.ts.map +1 -1
- package/dist/endor-findings.js +103 -45
- package/dist/endor-findings.js.map +1 -1
- package/dist/errors.d.ts +1 -1
- package/dist/errors.d.ts.map +1 -1
- package/dist/errors.js +8 -1
- package/dist/errors.js.map +1 -1
- package/dist/external-findings-import.d.ts +5 -3
- package/dist/external-findings-import.d.ts.map +1 -1
- package/dist/external-findings-import.js +7 -6
- package/dist/external-findings-import.js.map +1 -1
- package/dist/external-findings-local.d.ts +7 -5
- package/dist/external-findings-local.d.ts.map +1 -1
- package/dist/external-findings-local.js +337 -89
- package/dist/external-findings-local.js.map +1 -1
- package/dist/external-findings-publish.d.ts +8 -6
- package/dist/external-findings-publish.d.ts.map +1 -1
- package/dist/external-findings-publish.js +1318 -258
- package/dist/external-findings-publish.js.map +1 -1
- package/dist/external-findings-read.d.ts +20 -2
- package/dist/external-findings-read.d.ts.map +1 -1
- package/dist/external-findings-read.js +148 -66
- package/dist/external-findings-read.js.map +1 -1
- package/dist/external-findings.d.ts +15 -3
- package/dist/external-findings.d.ts.map +1 -1
- package/dist/external-findings.js +42 -1
- package/dist/external-findings.js.map +1 -1
- package/dist/external-import-contract.d.ts +5 -1
- package/dist/external-import-contract.d.ts.map +1 -1
- package/dist/external-import-contract.js +23 -9
- package/dist/external-import-contract.js.map +1 -1
- package/dist/external-import-models.d.ts +1 -1
- package/dist/external-import-models.d.ts.map +1 -1
- package/dist/external-import-models.js.map +1 -1
- package/dist/feedback.d.ts.map +1 -1
- package/dist/feedback.js +5 -4
- package/dist/feedback.js.map +1 -1
- package/dist/finding-prompt.d.ts +5 -0
- package/dist/finding-prompt.d.ts.map +1 -0
- package/dist/finding-prompt.js +32 -0
- package/dist/finding-prompt.js.map +1 -0
- package/dist/findings-client.d.ts +1 -0
- package/dist/findings-client.d.ts.map +1 -1
- package/dist/findings-client.js +27 -3
- package/dist/findings-client.js.map +1 -1
- package/dist/github-advisories.d.ts.map +1 -1
- package/dist/github-advisories.js +0 -2
- package/dist/github-advisories.js.map +1 -1
- package/dist/github-dependabot-findings.d.ts.map +1 -1
- package/dist/github-dependabot-findings.js +15 -4
- package/dist/github-dependabot-findings.js.map +1 -1
- package/dist/github-findings.d.ts +4 -1
- package/dist/github-findings.d.ts.map +1 -1
- package/dist/github-findings.js +55 -30
- package/dist/github-findings.js.map +1 -1
- package/dist/hosted-git-remotes.d.ts +5 -0
- package/dist/hosted-git-remotes.d.ts.map +1 -0
- package/dist/hosted-git-remotes.js +285 -0
- package/dist/hosted-git-remotes.js.map +1 -0
- package/dist/hosted-git-repository.d.ts +28 -0
- package/dist/hosted-git-repository.d.ts.map +1 -0
- package/dist/hosted-git-repository.js +222 -0
- package/dist/hosted-git-repository.js.map +1 -0
- package/dist/hosted-scan-protocol.js +2 -2
- package/dist/hosted-scan-protocol.js.map +1 -1
- package/dist/hosted-scan.d.ts.map +1 -1
- package/dist/hosted-scan.js +16 -11
- package/dist/hosted-scan.js.map +1 -1
- package/dist/hosted-scanner-http.d.ts +21 -0
- package/dist/hosted-scanner-http.d.ts.map +1 -0
- package/dist/hosted-scanner-http.js +204 -0
- package/dist/hosted-scanner-http.js.map +1 -0
- package/dist/hosted-scanner-v1.d.ts +6 -0
- package/dist/hosted-scanner-v1.d.ts.map +1 -0
- package/dist/hosted-scanner-v1.js +60 -0
- package/dist/hosted-scanner-v1.js.map +1 -0
- package/dist/import-scan.d.ts.map +1 -1
- package/dist/import-scan.js +3 -0
- package/dist/import-scan.js.map +1 -1
- package/dist/index.d.ts +18 -7
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +10 -2
- package/dist/index.js.map +1 -1
- package/dist/inspector-findings.d.ts.map +1 -1
- package/dist/inspector-findings.js +47 -65
- package/dist/inspector-findings.js.map +1 -1
- package/dist/knowledge-base.d.ts.map +1 -1
- package/dist/knowledge-base.js +68 -5
- package/dist/knowledge-base.js.map +1 -1
- package/dist/local-git-metadata.d.ts +1 -1
- package/dist/local-git-metadata.d.ts.map +1 -1
- package/dist/local-git-metadata.js +1 -2
- package/dist/local-git-metadata.js.map +1 -1
- package/dist/multiscan.d.ts +6 -4
- package/dist/multiscan.d.ts.map +1 -1
- package/dist/multiscan.js +138 -65
- package/dist/multiscan.js.map +1 -1
- package/dist/native-json-findings.d.ts +2 -1
- package/dist/native-json-findings.d.ts.map +1 -1
- package/dist/native-json-findings.js +12 -2
- package/dist/native-json-findings.js.map +1 -1
- package/dist/opengrep-findings.d.ts +1 -0
- package/dist/opengrep-findings.d.ts.map +1 -1
- package/dist/opengrep-findings.js +17 -13
- package/dist/opengrep-findings.js.map +1 -1
- package/dist/operation-telemetry.d.ts +104 -0
- package/dist/operation-telemetry.d.ts.map +1 -0
- package/dist/operation-telemetry.js +293 -0
- package/dist/operation-telemetry.js.map +1 -0
- package/dist/plugin-python-probe.d.ts +4 -0
- package/dist/plugin-python-probe.d.ts.map +1 -0
- package/dist/plugin-python-probe.js +10 -0
- package/dist/plugin-python-probe.js.map +1 -0
- package/dist/private-finding-import.d.ts +97 -2
- package/dist/private-finding-import.d.ts.map +1 -1
- package/dist/private-finding-import.js +58 -34
- package/dist/private-finding-import.js.map +1 -1
- package/dist/provider-profile.d.ts +1 -1
- package/dist/provider-profile.d.ts.map +1 -1
- package/dist/provider-profile.js +8 -1
- package/dist/provider-profile.js.map +1 -1
- package/dist/publication-telemetry.d.ts +45 -0
- package/dist/publication-telemetry.d.ts.map +1 -0
- package/dist/publication-telemetry.js +50 -0
- package/dist/publication-telemetry.js.map +1 -0
- package/dist/publish.d.ts +4 -0
- package/dist/publish.d.ts.map +1 -1
- package/dist/publish.js +42 -2
- package/dist/publish.js.map +1 -1
- package/dist/reader-selection.d.ts +2 -0
- package/dist/reader-selection.d.ts.map +1 -1
- package/dist/reader-selection.js +8 -0
- package/dist/reader-selection.js.map +1 -1
- package/dist/remediation.d.ts +1 -4
- package/dist/remediation.d.ts.map +1 -1
- package/dist/remediation.js +3 -7
- package/dist/remediation.js.map +1 -1
- package/dist/request-metadata.d.ts +3 -0
- package/dist/request-metadata.d.ts.map +1 -1
- package/dist/request-metadata.js +9 -0
- package/dist/request-metadata.js.map +1 -1
- package/dist/result.d.ts +4 -0
- package/dist/result.d.ts.map +1 -1
- package/dist/result.js +1 -1
- package/dist/result.js.map +1 -1
- package/dist/retry-windows-rename.d.ts +8 -0
- package/dist/retry-windows-rename.d.ts.map +1 -0
- package/dist/retry-windows-rename.js +24 -0
- package/dist/retry-windows-rename.js.map +1 -0
- package/dist/runtime.d.ts +20 -0
- package/dist/runtime.d.ts.map +1 -1
- package/dist/runtime.js +313 -110
- package/dist/runtime.js.map +1 -1
- package/dist/saved-scan-bootstrap.d.ts +1 -0
- package/dist/saved-scan-bootstrap.d.ts.map +1 -1
- package/dist/saved-scan-bootstrap.js +18 -15
- package/dist/saved-scan-bootstrap.js.map +1 -1
- package/dist/scan-activity.d.ts.map +1 -1
- package/dist/scan-activity.js +141 -56
- package/dist/scan-activity.js.map +1 -1
- package/dist/scan-comparison.d.ts +10 -5
- package/dist/scan-comparison.d.ts.map +1 -1
- package/dist/scan-comparison.js +60 -15
- package/dist/scan-comparison.js.map +1 -1
- package/dist/scan-dashboard.d.ts +6 -6
- package/dist/scan-dashboard.d.ts.map +1 -1
- package/dist/scan-dashboard.js +75 -42
- package/dist/scan-dashboard.js.map +1 -1
- package/dist/scan-executor.d.ts +10 -1
- package/dist/scan-executor.d.ts.map +1 -1
- package/dist/scan-executor.js +22 -2
- package/dist/scan-executor.js.map +1 -1
- package/dist/scan-history-renderer.d.ts.map +1 -1
- package/dist/scan-history-renderer.js +9 -19
- package/dist/scan-history-renderer.js.map +1 -1
- package/dist/scan-logs.d.ts +12 -0
- package/dist/scan-logs.d.ts.map +1 -1
- package/dist/scan-logs.js +106 -77
- package/dist/scan-logs.js.map +1 -1
- package/dist/scan-measurement.d.ts +26 -0
- package/dist/scan-measurement.d.ts.map +1 -0
- package/dist/scan-measurement.js +77 -0
- package/dist/scan-measurement.js.map +1 -0
- package/dist/scan-progress.d.ts +1 -0
- package/dist/scan-progress.d.ts.map +1 -1
- package/dist/scan-progress.js +3 -0
- package/dist/scan-progress.js.map +1 -1
- package/dist/scan-sessions.d.ts.map +1 -1
- package/dist/scan-sessions.js +4 -1
- package/dist/scan-sessions.js.map +1 -1
- package/dist/scan-settings.d.ts +1 -1
- package/dist/scan-settings.d.ts.map +1 -1
- package/dist/scan-settings.js +1 -24
- package/dist/scan-settings.js.map +1 -1
- package/dist/scanner-import.d.ts +20 -2
- package/dist/scanner-import.d.ts.map +1 -1
- package/dist/scanner-import.js +200 -8
- package/dist/scanner-import.js.map +1 -1
- package/dist/scanner-repository-url.d.ts +4 -1
- package/dist/scanner-repository-url.d.ts.map +1 -1
- package/dist/scanner-repository-url.js +10 -6
- package/dist/scanner-repository-url.js.map +1 -1
- package/dist/security-policy.d.ts +1 -1
- package/dist/security-policy.d.ts.map +1 -1
- package/dist/security-policy.js.map +1 -1
- package/dist/semgrep-findings.d.ts +6 -3
- package/dist/semgrep-findings.d.ts.map +1 -1
- package/dist/semgrep-findings.js +107 -43
- package/dist/semgrep-findings.js.map +1 -1
- package/dist/semgrep-guardian-findings.d.ts +38 -0
- package/dist/semgrep-guardian-findings.d.ts.map +1 -0
- package/dist/semgrep-guardian-findings.js +165 -0
- package/dist/semgrep-guardian-findings.js.map +1 -0
- package/dist/semgrep-platform-collector.d.ts +26 -0
- package/dist/semgrep-platform-collector.d.ts.map +1 -0
- package/dist/semgrep-platform-collector.js +108 -0
- package/dist/semgrep-platform-collector.js.map +1 -0
- package/dist/semgrep-platform-findings.d.ts +207 -6
- package/dist/semgrep-platform-findings.d.ts.map +1 -1
- package/dist/semgrep-platform-findings.js +983 -103
- package/dist/semgrep-platform-findings.js.map +1 -1
- package/dist/semgrep-platform-v1.d.ts +6 -0
- package/dist/semgrep-platform-v1.d.ts.map +1 -0
- package/dist/semgrep-platform-v1.js +83 -0
- package/dist/semgrep-platform-v1.js.map +1 -0
- package/dist/server/api.d.ts +1 -1
- package/dist/server/api.d.ts.map +1 -1
- package/dist/server/api.js.map +1 -1
- package/dist/server/embedding-tokenizer.cdx.json +33 -0
- package/dist/server/embedding-tokenizer.d.ts +2 -0
- package/dist/server/embedding-tokenizer.d.ts.map +1 -0
- package/dist/server/embedding-tokenizer.js +322 -0
- package/dist/server/embedding-tokenizer.js.map +6 -0
- package/dist/server/embeddings.d.ts +16 -2
- package/dist/server/embeddings.d.ts.map +1 -1
- package/dist/server/embeddings.js +35 -5
- package/dist/server/embeddings.js.map +1 -1
- package/dist/session-lines.d.ts +5 -0
- package/dist/session-lines.d.ts.map +1 -0
- package/dist/session-lines.js +60 -0
- package/dist/session-lines.js.map +1 -0
- package/dist/severity-review.d.ts +3 -1
- package/dist/severity-review.d.ts.map +1 -1
- package/dist/severity-review.js +3 -2
- package/dist/severity-review.js.map +1 -1
- package/dist/skill-authentication.d.ts +1 -0
- package/dist/skill-authentication.d.ts.map +1 -1
- package/dist/skill-authentication.js +1 -0
- package/dist/skill-authentication.js.map +1 -1
- package/dist/snyk-findings.d.ts +7 -2
- package/dist/snyk-findings.d.ts.map +1 -1
- package/dist/snyk-findings.js +93 -70
- package/dist/snyk-findings.js.map +1 -1
- package/dist/snyk-rest-findings.d.ts +76 -0
- package/dist/snyk-rest-findings.d.ts.map +1 -0
- package/dist/snyk-rest-findings.js +1051 -0
- package/dist/snyk-rest-findings.js.map +1 -0
- package/dist/snyk-rest-v1.d.ts +28 -0
- package/dist/snyk-rest-v1.d.ts.map +1 -0
- package/dist/snyk-rest-v1.js +132 -0
- package/dist/snyk-rest-v1.js.map +1 -0
- package/dist/snyk-token-origin.d.ts +4 -0
- package/dist/snyk-token-origin.d.ts.map +1 -0
- package/dist/snyk-token-origin.js +82 -0
- package/dist/snyk-token-origin.js.map +1 -0
- package/dist/sonar-collector.d.ts.map +1 -1
- package/dist/sonar-collector.js +0 -3
- package/dist/sonar-collector.js.map +1 -1
- package/dist/sonar-import.d.ts.map +1 -1
- package/dist/sonar-import.js +2 -4
- package/dist/sonar-import.js.map +1 -1
- package/dist/target-drift.d.ts +9 -0
- package/dist/target-drift.d.ts.map +1 -0
- package/dist/target-drift.js +27 -0
- package/dist/target-drift.js.map +1 -0
- package/dist/targets.d.ts +2 -0
- package/dist/targets.d.ts.map +1 -1
- package/dist/targets.js +56 -20
- package/dist/targets.js.map +1 -1
- package/dist/tenable-findings.d.ts +9 -0
- package/dist/tenable-findings.d.ts.map +1 -0
- package/dist/tenable-findings.js +122 -0
- package/dist/tenable-findings.js.map +1 -0
- package/dist/terminal-stream.d.ts +13 -0
- package/dist/terminal-stream.d.ts.map +1 -0
- package/dist/terminal-stream.js +35 -0
- package/dist/terminal-stream.js.map +1 -0
- package/dist/trivy-findings.d.ts +19 -0
- package/dist/trivy-findings.d.ts.map +1 -0
- package/dist/trivy-findings.js +435 -0
- package/dist/trivy-findings.js.map +1 -0
- package/dist/trivy-import.d.ts +19 -0
- package/dist/trivy-import.d.ts.map +1 -0
- package/dist/trivy-import.js +151 -0
- package/dist/trivy-import.js.map +1 -0
- package/dist/validation-records.js +1 -1
- package/dist/validation-records.js.map +1 -1
- package/dist/veracode-findings.d.ts +2 -0
- package/dist/veracode-findings.d.ts.map +1 -1
- package/dist/veracode-findings.js +49 -11
- package/dist/veracode-findings.js.map +1 -1
- package/dist/vertex-pricing.d.ts +8 -0
- package/dist/vertex-pricing.d.ts.map +1 -0
- package/dist/vertex-pricing.js +20 -0
- package/dist/vertex-pricing.js.map +1 -0
- package/dist/windows-path.d.ts +1 -0
- package/dist/windows-path.d.ts.map +1 -1
- package/dist/windows-path.js +26 -1
- package/dist/windows-path.js.map +1 -1
- package/dist/wiz-findings.d.ts +4 -0
- package/dist/wiz-findings.d.ts.map +1 -1
- package/dist/wiz-findings.js +57 -3
- package/dist/wiz-findings.js.map +1 -1
- package/docs/classify-severity-records.md +27 -12
- package/docs/cli.md +497 -550
- package/docs/dedupe-records.md +44 -24
- package/docs/findings-service.md +66 -39
- package/docs/hosted-remediation.md +14 -7
- package/docs/hosted-scans.md +50 -42
- package/docs/telemetry.md +236 -0
- package/docs/validate-records.md +78 -44
- package/package.json +18 -15
- package/schemas/external-findings.schema.json +3 -1
- package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
- package/_bundled_plugin/mcp/helpers.mjs.br.part-001 +0 -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/mcp/server.mjs.br.part-002 +0 -0
- package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +0 -96
- package/dist/external-imports-feature.d.ts +0 -6
- package/dist/external-imports-feature.d.ts.map +0 -1
- package/dist/external-imports-feature.js +0 -51
- package/dist/external-imports-feature.js.map +0 -1
- package/dist/finding-normalization.d.ts +0 -5
- package/dist/finding-normalization.d.ts.map +0 -1
- package/dist/finding-normalization.js +0 -155
- package/dist/finding-normalization.js.map +0 -1
|
@@ -1,9 +1,13 @@
|
|
|
1
|
-
import { posix } from "node:path";
|
|
2
1
|
import { previousAdmission, validateExternalEvidenceJson, validateExternalReport, } from "./external-import-contract.js";
|
|
3
2
|
import { canonicalJson } from "./record.js";
|
|
4
3
|
import { errorMessage } from "./errors.js";
|
|
5
|
-
import { messageText, parseNativeJsonResult, projectNativeJsonResult, sourceRepositoryUrl, } from "./native-json-findings.js";
|
|
6
|
-
import { trackReaderSelection, array, readScannerJson, record,
|
|
4
|
+
import { messageText, nativeResultPath, parseNativeJsonResult, projectNativeJsonResult, sourceRepositoryUrl, } from "./native-json-findings.js";
|
|
5
|
+
import { trackReaderSelection, array, readScannerJson, record, requiredText, stableId, } from "./scanner-import.js";
|
|
6
|
+
// Occurrences are sorted by ID and can retain traces from nonadjacent input rows.
|
|
7
|
+
const sourcePositions = new WeakMap();
|
|
8
|
+
export function getOpenGrepSourcePositions(findings) {
|
|
9
|
+
return Array.isArray(findings) ? sourcePositions.get(findings) : undefined;
|
|
10
|
+
}
|
|
7
11
|
/** Import native scanner evidence without assigning a Codex assessment. */
|
|
8
12
|
export function normalizeOpenGrepFindings(input, options, target = "cloud") {
|
|
9
13
|
const document = record(input, "OpenGrep report");
|
|
@@ -123,15 +127,7 @@ export function normalizeOpenGrepFindings(input, options, target = "cloud") {
|
|
|
123
127
|
for (const [index, value] of values.entries()) {
|
|
124
128
|
let id = null;
|
|
125
129
|
try {
|
|
126
|
-
const parsed = parseNativeJsonResult(value, "OpenGrep");
|
|
127
|
-
if (parsed.path !== null) {
|
|
128
|
-
// Validate the emitted spelling across platforms, keeping literal POSIX backslashes.
|
|
129
|
-
const path = posix.normalize(parsed.rawPath);
|
|
130
|
-
parsed.path =
|
|
131
|
-
relativePath(posix.normalize(path.replaceAll("\\", "/"))) === null
|
|
132
|
-
? null
|
|
133
|
-
: path;
|
|
134
|
-
}
|
|
130
|
+
const parsed = parseNativeJsonResult(value, "OpenGrep", nativeResultPath);
|
|
135
131
|
// Native fingerprint counters change when another analysis pass adds matches.
|
|
136
132
|
// A source move creates a new occurrence; this is not cross-revision matching.
|
|
137
133
|
id = stableId("opengrep-location", [
|
|
@@ -151,9 +147,15 @@ export function normalizeOpenGrepFindings(input, options, target = "cloud") {
|
|
|
151
147
|
exclude(index + 1, id, error);
|
|
152
148
|
}
|
|
153
149
|
}
|
|
150
|
+
const positions = new Map();
|
|
154
151
|
for (const [id, observations] of [...groups].sort(([left], [right]) => left < right ? -1 : left > right ? 1 : 0)) {
|
|
155
152
|
if (observations.length === 1) {
|
|
156
|
-
|
|
153
|
+
const { position } = observations[0];
|
|
154
|
+
selection.append(position, id, () => {
|
|
155
|
+
const evidence = projectGroup(observations);
|
|
156
|
+
positions.set(id, [position]);
|
|
157
|
+
return evidence;
|
|
158
|
+
});
|
|
157
159
|
continue;
|
|
158
160
|
}
|
|
159
161
|
const ordered = observations
|
|
@@ -197,6 +199,7 @@ export function normalizeOpenGrepFindings(input, options, target = "cloud") {
|
|
|
197
199
|
if (previousAdmission(evidence) === null)
|
|
198
200
|
selection.uncertainIds.add(id);
|
|
199
201
|
output.findings.push({ source_finding_id: id, evidence });
|
|
202
|
+
positions.set(id, retained.map(({ position }) => position));
|
|
200
203
|
}
|
|
201
204
|
catch (error) {
|
|
202
205
|
for (const observation of retained)
|
|
@@ -204,6 +207,7 @@ export function normalizeOpenGrepFindings(input, options, target = "cloud") {
|
|
|
204
207
|
}
|
|
205
208
|
}
|
|
206
209
|
output.excluded.sort((left, right) => left.position - right.position);
|
|
210
|
+
sourcePositions.set(output.findings, positions);
|
|
207
211
|
return selection.finish();
|
|
208
212
|
}
|
|
209
213
|
export async function readOpenGrepFindings(path, options, target = "cloud") {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"opengrep-findings.js","sourceRoot":"","sources":["../src/opengrep-findings.ts"],"names":[],"mappings":"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","sourcesContent":["import { posix } from \"node:path\";\nimport {\n previousAdmission,\n validateExternalEvidenceJson,\n validateExternalReport,\n type ExternalImportTarget,\n} from \"./external-import-contract.js\";\nimport { canonicalJson } from \"./record.js\";\nimport { errorMessage } from \"./errors.js\";\nimport type { ExternalFindings } from \"./external-findings.js\";\nimport {\n messageText,\n parseNativeJsonResult,\n projectNativeJsonResult,\n sourceRepositoryUrl,\n} from \"./native-json-findings.js\";\nimport {\n trackReaderSelection,\n array,\n readScannerJson,\n record,\n relativePath,\n requiredText,\n stableId,\n} from \"./scanner-import.js\";\n\nexport interface OpenGrepImportOptions {\n /** Source repository declared by the caller, independent of the destination. */\n sourceRepositoryUrl: string;\n}\n\n/** Import native scanner evidence without assigning a Codex assessment. */\nexport function normalizeOpenGrepFindings(\n input: unknown,\n options: OpenGrepImportOptions,\n target: ExternalImportTarget = \"cloud\",\n): ExternalFindings {\n const document = record(input, \"OpenGrep report\");\n const repositoryUrl = sourceRepositoryUrl(\n options?.sourceRepositoryUrl,\n \"OpenGrep\",\n );\n const version = requiredText(document[\"version\"], \"OpenGrep version\");\n const { results, ...report } = document;\n const values = array(results, \"OpenGrep results\");\n const errors = array(report[\"errors\"], \"OpenGrep errors\");\n validateExternalReport(report);\n const projection = {\n origin: \"OpenGrep\",\n repositoryUrl,\n severity: () => \"unknown\",\n reportContext: { version },\n target,\n scanErrorCount: errors.length,\n };\n const output: ExternalFindings = {\n read: values.length,\n findings: [],\n excluded: [],\n report: structuredClone(report),\n };\n const selection = trackReaderSelection(output);\n type Observation = {\n position: number;\n parsed: ReturnType<typeof parseNativeJsonResult>;\n };\n function exclude(position: number, id: string | null, error: unknown) {\n if (id && error instanceof Error && previousAdmission(error) !== undefined)\n selection.uncertainIds.add(id);\n output.excluded.push({\n position,\n source_finding_id: id,\n reason: errorMessage(error),\n });\n }\n function projectGroup(observations: Observation[]) {\n const results = observations.map(({ parsed }) => parsed.result);\n if (results.length === 1)\n return projectNativeJsonResult(observations[0]!.parsed, {\n ...projection,\n observations: results,\n });\n const sourceData = {\n report: { version },\n scan_error_count: errors.length,\n results,\n };\n // Replacing [] with the same raw results adds the same wire bytes to every candidate.\n const rawBytes =\n validateExternalEvidenceJson({ source_data: sourceData }, target) -\n validateExternalEvidenceJson(\n { source_data: { ...sourceData, results: [] } },\n target,\n );\n let projectionError: unknown;\n for (const { parsed } of observations) {\n try {\n const evidence = projectNativeJsonResult(parsed, {\n ...projection,\n observations: [],\n });\n validateExternalEvidenceJson(evidence, target, rawBytes);\n evidence.source_data![\"results\"] = results;\n return evidence;\n } catch (error) {\n projectionError ??= error;\n }\n }\n throw projectionError;\n }\n function retainPublishableTraces(observations: Observation[], id: string) {\n const emptyWrapperBytes = validateExternalEvidenceJson(\n { source_data: { results: [] } },\n target,\n );\n function sizeWithTrace(observation: Observation, evidenceBytes: number) {\n return validateExternalEvidenceJson(\n { source_data: { results: [observation.parsed.result] } },\n target,\n evidenceBytes - emptyWrapperBytes,\n );\n }\n const singletonErrors = new Map<Observation, string>();\n let smallestProjectionBytes = Infinity;\n let coreRawBytes = 0;\n for (const observation of observations) {\n try {\n const evidence = projectNativeJsonResult(observation.parsed, {\n ...projection,\n observations: [],\n });\n const projectedBytes = validateExternalEvidenceJson(evidence, target);\n const singletonBytes = sizeWithTrace(observation, projectedBytes);\n coreRawBytes += singletonBytes - projectedBytes;\n smallestProjectionBytes = Math.min(\n smallestProjectionBytes,\n projectedBytes,\n );\n } catch (error) {\n if (error instanceof Error && previousAdmission(error) !== undefined)\n selection.uncertainIds.add(id);\n singletonErrors.set(observation, errorMessage(error));\n }\n }\n if (!singletonErrors.size) return observations;\n // Reserve every independently publishable trace, including the commas in\n // their results array, before trying raw-only traces in canonical order.\n const coreCount = observations.length - singletonErrors.size;\n let groupBytes = smallestProjectionBytes + coreRawBytes + coreCount - 1;\n return observations.filter((observation) => {\n let reason = singletonErrors.get(observation);\n if (reason === undefined) return true;\n if (coreCount) {\n try {\n groupBytes = sizeWithTrace(observation, groupBytes + 1);\n return true;\n } catch (error) {\n const groupReason = errorMessage(error);\n if (groupReason !== reason)\n reason = `${groupReason} This trace also fails standalone validation. ${reason}`;\n }\n }\n exclude(observation.position, id, reason);\n return false;\n });\n }\n const groups = new Map<string, Observation[]>();\n for (const [index, value] of values.entries()) {\n let id: string | null = null;\n try {\n const parsed = parseNativeJsonResult(value, \"OpenGrep\");\n if (parsed.path !== null) {\n // Validate the emitted spelling across platforms, keeping literal POSIX backslashes.\n const path = posix.normalize(parsed.rawPath);\n parsed.path =\n relativePath(posix.normalize(path.replaceAll(\"\\\\\", \"/\"))) === null\n ? null\n : path;\n }\n // Native fingerprint counters change when another analysis pass adds matches.\n // A source move creates a new occurrence; this is not cross-revision matching.\n id = stableId(\"opengrep-location\", [\n parsed.rule,\n parsed.path ?? parsed.rawPath,\n parsed.line,\n parsed.column,\n parsed.endLine,\n parsed.endColumn,\n ]);\n messageText(parsed.extra[\"message\"], \"OpenGrep\");\n const group = groups.get(id) ?? [];\n group.push({ position: index + 1, parsed });\n groups.set(id, group);\n } catch (error) {\n exclude(index + 1, id, error);\n }\n }\n for (const [id, observations] of [...groups].sort(([left], [right]) =>\n left < right ? -1 : left > right ? 1 : 0,\n )) {\n if (observations.length === 1) {\n selection.append(observations[0]!.position, id, () =>\n projectGroup(observations),\n );\n continue;\n }\n const ordered = observations\n .flatMap((observation) => {\n try {\n const result = structuredClone(observation.parsed.result);\n // The group adds these same raw bytes when choosing a representative\n // and deciding which traces fit alongside it.\n validateExternalEvidenceJson(\n { source_data: { results: [result] } },\n target,\n 0,\n (previousBytes, currentBytes) => {\n if (previousBytes !== currentBytes)\n selection.uncertainIds.add(id);\n },\n );\n observation.parsed.result = result;\n return [{ observation, key: canonicalJson(result) }];\n } catch (error) {\n exclude(observation.position, id, error);\n return [];\n }\n })\n .sort((left, right) =>\n left.key < right.key ? -1 : left.key > right.key ? 1 : 0,\n )\n .map(({ observation }) => observation);\n if (!ordered.length) continue;\n let retained = ordered;\n try {\n let evidence;\n try {\n evidence = projectGroup(retained);\n } catch (error) {\n if (retained.length === 1) throw error;\n retained = retainPublishableTraces(retained, id);\n if (!retained.length) continue;\n if (retained.length === ordered.length) throw error;\n evidence = projectGroup(retained);\n }\n if (previousAdmission(evidence) === null) selection.uncertainIds.add(id);\n output.findings.push({ source_finding_id: id, evidence });\n } catch (error) {\n for (const observation of retained)\n exclude(observation.position, id, error);\n }\n }\n output.excluded.sort((left, right) => left.position - right.position);\n return selection.finish();\n}\n\nexport async function readOpenGrepFindings(\n path: string,\n options: OpenGrepImportOptions,\n target: ExternalImportTarget = \"cloud\",\n): Promise<ExternalFindings> {\n return normalizeOpenGrepFindings(\n await readScannerJson(path),\n options,\n target,\n );\n}\n"]}
|
|
1
|
+
{"version":3,"file":"opengrep-findings.js","sourceRoot":"","sources":["../src/opengrep-findings.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n previousAdmission,\n validateExternalEvidenceJson,\n validateExternalReport,\n type ExternalImportTarget,\n} from \"./external-import-contract.js\";\nimport { canonicalJson } from \"./record.js\";\nimport { errorMessage } from \"./errors.js\";\nimport type { ExternalFindings } from \"./external-findings.js\";\nimport {\n messageText,\n nativeResultPath,\n parseNativeJsonResult,\n projectNativeJsonResult,\n sourceRepositoryUrl,\n} from \"./native-json-findings.js\";\nimport {\n trackReaderSelection,\n array,\n readScannerJson,\n record,\n requiredText,\n stableId,\n} from \"./scanner-import.js\";\n\nexport interface OpenGrepImportOptions {\n /** Source repository declared by the caller, independent of the destination. */\n sourceRepositoryUrl: string;\n}\n\n// Occurrences are sorted by ID and can retain traces from nonadjacent input rows.\nconst sourcePositions = new WeakMap<\n ExternalFindings[\"findings\"],\n ReadonlyMap<string, readonly number[]>\n>();\n\nexport function getOpenGrepSourcePositions(findings: unknown) {\n return Array.isArray(findings) ? sourcePositions.get(findings) : undefined;\n}\n\n/** Import native scanner evidence without assigning a Codex assessment. */\nexport function normalizeOpenGrepFindings(\n input: unknown,\n options: OpenGrepImportOptions,\n target: ExternalImportTarget = \"cloud\",\n): ExternalFindings {\n const document = record(input, \"OpenGrep report\");\n const repositoryUrl = sourceRepositoryUrl(\n options?.sourceRepositoryUrl,\n \"OpenGrep\",\n );\n const version = requiredText(document[\"version\"], \"OpenGrep version\");\n const { results, ...report } = document;\n const values = array(results, \"OpenGrep results\");\n const errors = array(report[\"errors\"], \"OpenGrep errors\");\n validateExternalReport(report);\n const projection = {\n origin: \"OpenGrep\",\n repositoryUrl,\n severity: () => \"unknown\",\n reportContext: { version },\n target,\n scanErrorCount: errors.length,\n };\n const output: ExternalFindings = {\n read: values.length,\n findings: [],\n excluded: [],\n report: structuredClone(report),\n };\n const selection = trackReaderSelection(output);\n type Observation = {\n position: number;\n parsed: ReturnType<typeof parseNativeJsonResult>;\n };\n function exclude(position: number, id: string | null, error: unknown) {\n if (id && error instanceof Error && previousAdmission(error) !== undefined)\n selection.uncertainIds.add(id);\n output.excluded.push({\n position,\n source_finding_id: id,\n reason: errorMessage(error),\n });\n }\n function projectGroup(observations: Observation[]) {\n const results = observations.map(({ parsed }) => parsed.result);\n if (results.length === 1)\n return projectNativeJsonResult(observations[0]!.parsed, {\n ...projection,\n observations: results,\n });\n const sourceData = {\n report: { version },\n scan_error_count: errors.length,\n results,\n };\n // Replacing [] with the same raw results adds the same wire bytes to every candidate.\n const rawBytes =\n validateExternalEvidenceJson({ source_data: sourceData }, target) -\n validateExternalEvidenceJson(\n { source_data: { ...sourceData, results: [] } },\n target,\n );\n let projectionError: unknown;\n for (const { parsed } of observations) {\n try {\n const evidence = projectNativeJsonResult(parsed, {\n ...projection,\n observations: [],\n });\n validateExternalEvidenceJson(evidence, target, rawBytes);\n evidence.source_data![\"results\"] = results;\n return evidence;\n } catch (error) {\n projectionError ??= error;\n }\n }\n throw projectionError;\n }\n function retainPublishableTraces(observations: Observation[], id: string) {\n const emptyWrapperBytes = validateExternalEvidenceJson(\n { source_data: { results: [] } },\n target,\n );\n function sizeWithTrace(observation: Observation, evidenceBytes: number) {\n return validateExternalEvidenceJson(\n { source_data: { results: [observation.parsed.result] } },\n target,\n evidenceBytes - emptyWrapperBytes,\n );\n }\n const singletonErrors = new Map<Observation, string>();\n let smallestProjectionBytes = Infinity;\n let coreRawBytes = 0;\n for (const observation of observations) {\n try {\n const evidence = projectNativeJsonResult(observation.parsed, {\n ...projection,\n observations: [],\n });\n const projectedBytes = validateExternalEvidenceJson(evidence, target);\n const singletonBytes = sizeWithTrace(observation, projectedBytes);\n coreRawBytes += singletonBytes - projectedBytes;\n smallestProjectionBytes = Math.min(\n smallestProjectionBytes,\n projectedBytes,\n );\n } catch (error) {\n if (error instanceof Error && previousAdmission(error) !== undefined)\n selection.uncertainIds.add(id);\n singletonErrors.set(observation, errorMessage(error));\n }\n }\n if (!singletonErrors.size) return observations;\n // Reserve every independently publishable trace, including the commas in\n // their results array, before trying raw-only traces in canonical order.\n const coreCount = observations.length - singletonErrors.size;\n let groupBytes = smallestProjectionBytes + coreRawBytes + coreCount - 1;\n return observations.filter((observation) => {\n let reason = singletonErrors.get(observation);\n if (reason === undefined) return true;\n if (coreCount) {\n try {\n groupBytes = sizeWithTrace(observation, groupBytes + 1);\n return true;\n } catch (error) {\n const groupReason = errorMessage(error);\n if (groupReason !== reason)\n reason = `${groupReason} This trace also fails standalone validation. ${reason}`;\n }\n }\n exclude(observation.position, id, reason);\n return false;\n });\n }\n const groups = new Map<string, Observation[]>();\n for (const [index, value] of values.entries()) {\n let id: string | null = null;\n try {\n const parsed = parseNativeJsonResult(value, \"OpenGrep\", nativeResultPath);\n // Native fingerprint counters change when another analysis pass adds matches.\n // A source move creates a new occurrence; this is not cross-revision matching.\n id = stableId(\"opengrep-location\", [\n parsed.rule,\n parsed.path ?? parsed.rawPath,\n parsed.line,\n parsed.column,\n parsed.endLine,\n parsed.endColumn,\n ]);\n messageText(parsed.extra[\"message\"], \"OpenGrep\");\n const group = groups.get(id) ?? [];\n group.push({ position: index + 1, parsed });\n groups.set(id, group);\n } catch (error) {\n exclude(index + 1, id, error);\n }\n }\n const positions = new Map<string, number[]>();\n for (const [id, observations] of [...groups].sort(([left], [right]) =>\n left < right ? -1 : left > right ? 1 : 0,\n )) {\n if (observations.length === 1) {\n const { position } = observations[0]!;\n selection.append(position, id, () => {\n const evidence = projectGroup(observations);\n positions.set(id, [position]);\n return evidence;\n });\n continue;\n }\n const ordered = observations\n .flatMap((observation) => {\n try {\n const result = structuredClone(observation.parsed.result);\n // The group adds these same raw bytes when choosing a representative\n // and deciding which traces fit alongside it.\n validateExternalEvidenceJson(\n { source_data: { results: [result] } },\n target,\n 0,\n (previousBytes, currentBytes) => {\n if (previousBytes !== currentBytes)\n selection.uncertainIds.add(id);\n },\n );\n observation.parsed.result = result;\n return [{ observation, key: canonicalJson(result) }];\n } catch (error) {\n exclude(observation.position, id, error);\n return [];\n }\n })\n .sort((left, right) =>\n left.key < right.key ? -1 : left.key > right.key ? 1 : 0,\n )\n .map(({ observation }) => observation);\n if (!ordered.length) continue;\n let retained = ordered;\n try {\n let evidence;\n try {\n evidence = projectGroup(retained);\n } catch (error) {\n if (retained.length === 1) throw error;\n retained = retainPublishableTraces(retained, id);\n if (!retained.length) continue;\n if (retained.length === ordered.length) throw error;\n evidence = projectGroup(retained);\n }\n if (previousAdmission(evidence) === null) selection.uncertainIds.add(id);\n output.findings.push({ source_finding_id: id, evidence });\n positions.set(\n id,\n retained.map(({ position }) => position),\n );\n } catch (error) {\n for (const observation of retained)\n exclude(observation.position, id, error);\n }\n }\n output.excluded.sort((left, right) => left.position - right.position);\n sourcePositions.set(output.findings, positions);\n return selection.finish();\n}\n\nexport async function readOpenGrepFindings(\n path: string,\n options: OpenGrepImportOptions,\n target: ExternalImportTarget = \"cloud\",\n): Promise<ExternalFindings> {\n return normalizeOpenGrepFindings(\n await readScannerJson(path),\n options,\n target,\n );\n}\n"]}
|
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
import type { ScanUsageMeasurement } from "./cost.js";
|
|
2
|
+
export type OperationOutcome = "completed" | "failed" | "canceled" | "unresolved";
|
|
3
|
+
export type OperationFailureCategory = "configuration" | "authentication" | "input" | "budget" | "execution" | "canceled";
|
|
4
|
+
/** Content-free operational receipts. IDs are for joins, never metric labels. */
|
|
5
|
+
export interface OperationTelemetryEvent {
|
|
6
|
+
schemaVersion: 1;
|
|
7
|
+
eventId: string;
|
|
8
|
+
operationId: string;
|
|
9
|
+
attemptId: string;
|
|
10
|
+
parentAttemptId?: string;
|
|
11
|
+
/** Resumed scans share a cumulative measurement scope; never sum those receipts. */
|
|
12
|
+
usageScopeId: string;
|
|
13
|
+
occurredAt: string;
|
|
14
|
+
observedAt: string;
|
|
15
|
+
type: "attempt_started" | "attempt_finished";
|
|
16
|
+
command: "scan" | "patch" | "validate" | "policy" | "verify-fix" | "assess-patch-risk";
|
|
17
|
+
surface: "cli" | "sdk";
|
|
18
|
+
packageVersion: string;
|
|
19
|
+
mode?: "standard" | "deep";
|
|
20
|
+
resumed: boolean;
|
|
21
|
+
/** True when this call returned a saved result without starting new work. */
|
|
22
|
+
reusedResult?: boolean;
|
|
23
|
+
outcome?: OperationOutcome;
|
|
24
|
+
failureCategory?: OperationFailureCategory;
|
|
25
|
+
durationMs?: number;
|
|
26
|
+
measurement?: Readonly<ScanUsageMeasurement>;
|
|
27
|
+
findingCount?: number;
|
|
28
|
+
reviewedSurfaceCount?: number;
|
|
29
|
+
deferredCount?: number;
|
|
30
|
+
pluginVersion?: string;
|
|
31
|
+
providerFamily?: string;
|
|
32
|
+
validationDisposition?: "reportable" | "suppressed" | "not_applicable" | "deferred";
|
|
33
|
+
artifactComplete?: boolean;
|
|
34
|
+
collection: {
|
|
35
|
+
persisted: number;
|
|
36
|
+
writeFailures: number;
|
|
37
|
+
};
|
|
38
|
+
}
|
|
39
|
+
interface OperationTelemetryOptions {
|
|
40
|
+
directory: string;
|
|
41
|
+
protectedRepository?: string;
|
|
42
|
+
protectedOutput?: string;
|
|
43
|
+
command: OperationTelemetryEvent["command"];
|
|
44
|
+
surface: OperationTelemetryEvent["surface"];
|
|
45
|
+
mode?: OperationTelemetryEvent["mode"];
|
|
46
|
+
resumeScanId?: string;
|
|
47
|
+
deferPersistence?: boolean;
|
|
48
|
+
context?: {
|
|
49
|
+
operationId: string;
|
|
50
|
+
parentAttemptId?: string;
|
|
51
|
+
};
|
|
52
|
+
onEvent?: (event: Readonly<OperationTelemetryEvent>) => void;
|
|
53
|
+
onError?: (error: unknown) => void;
|
|
54
|
+
}
|
|
55
|
+
/** Local journal only. Export, acknowledgement and retention belong to the host. */
|
|
56
|
+
export declare class OperationTelemetry {
|
|
57
|
+
#private;
|
|
58
|
+
readonly attemptId: `${string}-${string}-${string}-${string}-${string}`;
|
|
59
|
+
operationId: string;
|
|
60
|
+
measurement: Readonly<ScanUsageMeasurement> | undefined;
|
|
61
|
+
reusedResult: boolean;
|
|
62
|
+
nativeTurnFailed: boolean;
|
|
63
|
+
constructor(options: OperationTelemetryOptions);
|
|
64
|
+
get context(): {
|
|
65
|
+
operationId: string;
|
|
66
|
+
attemptId: `${string}-${string}-${string}-${string}-${string}`;
|
|
67
|
+
parentAttemptId?: string | undefined;
|
|
68
|
+
};
|
|
69
|
+
start(): Promise<void>;
|
|
70
|
+
/** Callers establish repository and artifact protection before any writes. */
|
|
71
|
+
activatePersistence(protectedRoots: readonly string[], savedOutput?: string): Promise<void>;
|
|
72
|
+
bindScan(scanId: string): Promise<void>;
|
|
73
|
+
describe(runtime: Pick<OperationTelemetryEvent, "pluginVersion" | "providerFamily">): void;
|
|
74
|
+
finish(outcome: OperationOutcome, details?: Pick<OperationTelemetryEvent, "failureCategory" | "findingCount" | "artifactComplete" | "reviewedSurfaceCount" | "deferredCount" | "validationDisposition">): Promise<void>;
|
|
75
|
+
}
|
|
76
|
+
/** Read durable receipts, retaining explicit evidence of truncated/corrupt records. */
|
|
77
|
+
export declare function readOperationTelemetry(stateDirectory: string): Promise<{
|
|
78
|
+
events: OperationTelemetryEvent[];
|
|
79
|
+
parseFailures: number;
|
|
80
|
+
}>;
|
|
81
|
+
/** Attempts without a terminal receipt remain unresolved, including process loss. */
|
|
82
|
+
export declare function summarizeOperationTelemetry(events: readonly OperationTelemetryEvent[]): {
|
|
83
|
+
operations: number;
|
|
84
|
+
successfulOperations: number;
|
|
85
|
+
attempts: number;
|
|
86
|
+
outcomes: {
|
|
87
|
+
completed: number;
|
|
88
|
+
failed: number;
|
|
89
|
+
canceled: number;
|
|
90
|
+
unresolved: number;
|
|
91
|
+
};
|
|
92
|
+
usageCoverage: {
|
|
93
|
+
complete: number;
|
|
94
|
+
partial: number;
|
|
95
|
+
unavailable: number;
|
|
96
|
+
};
|
|
97
|
+
durationMs: number[];
|
|
98
|
+
observedCostUsd: number;
|
|
99
|
+
pricedAttempts: number;
|
|
100
|
+
reusedAttempts: number;
|
|
101
|
+
duplicates: number;
|
|
102
|
+
};
|
|
103
|
+
export {};
|
|
104
|
+
//# sourceMappingURL=operation-telemetry.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"operation-telemetry.d.ts","sourceRoot":"","sources":["../src/operation-telemetry.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,293 @@
|
|
|
1
|
+
import { createHash, randomUUID } from "node:crypto";
|
|
2
|
+
import { appendFile, mkdir, readFile, readdir, writeFile, } from "node:fs/promises";
|
|
3
|
+
import { join } from "node:path";
|
|
4
|
+
import { canonicalConfigPath, requireOutputOutsideRepositories, requireSecureOutputAncestry, } from "./runtime.js";
|
|
5
|
+
import { gitProtectionRoots } from "./targets.js";
|
|
6
|
+
import { VERSION } from "./version.js";
|
|
7
|
+
/** Local journal only. Export, acknowledgement and retention belong to the host. */
|
|
8
|
+
export class OperationTelemetry {
|
|
9
|
+
attemptId = randomUUID();
|
|
10
|
+
operationId;
|
|
11
|
+
measurement;
|
|
12
|
+
reusedResult = false;
|
|
13
|
+
nativeTurnFailed = false;
|
|
14
|
+
#started = performance.now();
|
|
15
|
+
#startedAt = new Date().toISOString();
|
|
16
|
+
#options;
|
|
17
|
+
#directory;
|
|
18
|
+
#persisted = 0;
|
|
19
|
+
#writeFailures = 0;
|
|
20
|
+
#ready = false;
|
|
21
|
+
#runtime = {};
|
|
22
|
+
#finished = false;
|
|
23
|
+
#usageScopeId = this.attemptId;
|
|
24
|
+
#deferred;
|
|
25
|
+
#startedEvent;
|
|
26
|
+
constructor(options) {
|
|
27
|
+
this.#options = options;
|
|
28
|
+
this.operationId = options.context?.operationId ?? randomUUID();
|
|
29
|
+
this.#directory = join(options.directory, "telemetry");
|
|
30
|
+
this.#deferred = options.deferPersistence === true;
|
|
31
|
+
}
|
|
32
|
+
get context() {
|
|
33
|
+
return {
|
|
34
|
+
operationId: this.operationId,
|
|
35
|
+
attemptId: this.attemptId,
|
|
36
|
+
...(this.#options.context?.parentAttemptId === undefined
|
|
37
|
+
? {}
|
|
38
|
+
: { parentAttemptId: this.#options.context.parentAttemptId }),
|
|
39
|
+
};
|
|
40
|
+
}
|
|
41
|
+
async start() {
|
|
42
|
+
if (!this.#deferred)
|
|
43
|
+
await this.#preparePersistence();
|
|
44
|
+
await this.#emit("attempt_started");
|
|
45
|
+
}
|
|
46
|
+
/** Callers establish repository and artifact protection before any writes. */
|
|
47
|
+
async activatePersistence(protectedRoots, savedOutput) {
|
|
48
|
+
if (!this.#deferred || this.#finished)
|
|
49
|
+
return;
|
|
50
|
+
this.#deferred = false;
|
|
51
|
+
await this.#preparePersistence(protectedRoots, savedOutput);
|
|
52
|
+
if (this.#startedEvent !== undefined) {
|
|
53
|
+
const event = {
|
|
54
|
+
...this.#startedEvent,
|
|
55
|
+
...this.context,
|
|
56
|
+
usageScopeId: this.#usageScopeId,
|
|
57
|
+
collection: {
|
|
58
|
+
persisted: this.#persisted + (this.#ready ? 1 : 0),
|
|
59
|
+
writeFailures: this.#writeFailures,
|
|
60
|
+
},
|
|
61
|
+
};
|
|
62
|
+
if (this.#ready)
|
|
63
|
+
await this.#persist(event);
|
|
64
|
+
if (this.#options.resumeScanId !== undefined)
|
|
65
|
+
this.#notify(event);
|
|
66
|
+
}
|
|
67
|
+
this.#startedEvent = undefined;
|
|
68
|
+
}
|
|
69
|
+
async #preparePersistence(additionalRoots = [], savedOutput) {
|
|
70
|
+
try {
|
|
71
|
+
const protectedRoots = [...additionalRoots];
|
|
72
|
+
for (const output of [this.#options.protectedOutput, savedOutput]) {
|
|
73
|
+
if (output !== undefined)
|
|
74
|
+
protectedRoots.push(await canonicalConfigPath(output));
|
|
75
|
+
}
|
|
76
|
+
if (this.#options.protectedRepository !== undefined) {
|
|
77
|
+
const repository = await canonicalConfigPath(this.#options.protectedRepository);
|
|
78
|
+
protectedRoots.push(repository, ...(await gitProtectionRoots(this.#options.protectedRepository)));
|
|
79
|
+
}
|
|
80
|
+
if (protectedRoots.length > 0) {
|
|
81
|
+
requireOutputOutsideRepositories(protectedRoots, await canonicalConfigPath(this.#directory), "runtime");
|
|
82
|
+
}
|
|
83
|
+
await requireSecureOutputAncestry(this.#directory);
|
|
84
|
+
await mkdir(this.#directory, { recursive: true, mode: 0o700 });
|
|
85
|
+
this.#ready = true;
|
|
86
|
+
if (this.#options.resumeScanId !== undefined) {
|
|
87
|
+
try {
|
|
88
|
+
const saved = JSON.parse(await readFile(this.#bindingPath(this.#options.resumeScanId), "utf8"));
|
|
89
|
+
this.operationId = saved.operationId;
|
|
90
|
+
this.#usageScopeId = saved.usageScopeId;
|
|
91
|
+
}
|
|
92
|
+
catch (error) {
|
|
93
|
+
if (error.code !== "ENOENT")
|
|
94
|
+
this.#error(error);
|
|
95
|
+
}
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
catch (error) {
|
|
99
|
+
this.#error(error);
|
|
100
|
+
}
|
|
101
|
+
}
|
|
102
|
+
async bindScan(scanId) {
|
|
103
|
+
if (!this.#ready)
|
|
104
|
+
return;
|
|
105
|
+
try {
|
|
106
|
+
await writeFile(this.#bindingPath(scanId), JSON.stringify({
|
|
107
|
+
...this.context,
|
|
108
|
+
usageScopeId: this.#usageScopeId,
|
|
109
|
+
}), {
|
|
110
|
+
mode: 0o600,
|
|
111
|
+
});
|
|
112
|
+
}
|
|
113
|
+
catch (error) {
|
|
114
|
+
this.#error(error);
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
describe(runtime) {
|
|
118
|
+
this.#runtime = runtime;
|
|
119
|
+
}
|
|
120
|
+
async finish(outcome, details = {}) {
|
|
121
|
+
if (this.#finished)
|
|
122
|
+
return;
|
|
123
|
+
this.#finished = true;
|
|
124
|
+
if (this.#startedEvent !== undefined &&
|
|
125
|
+
this.#options.resumeScanId !== undefined) {
|
|
126
|
+
this.#notify(this.#startedEvent);
|
|
127
|
+
this.#startedEvent = undefined;
|
|
128
|
+
}
|
|
129
|
+
await this.#emit("attempt_finished", {
|
|
130
|
+
outcome,
|
|
131
|
+
reusedResult: this.reusedResult,
|
|
132
|
+
durationMs: Math.max(0, performance.now() - this.#started),
|
|
133
|
+
...(this.measurement === undefined
|
|
134
|
+
? {}
|
|
135
|
+
: { measurement: this.measurement }),
|
|
136
|
+
...this.#runtime,
|
|
137
|
+
...details,
|
|
138
|
+
});
|
|
139
|
+
}
|
|
140
|
+
#bindingPath(scanId) {
|
|
141
|
+
return join(this.#directory, `${createHash("sha256").update(scanId).digest("hex")}.binding.json`);
|
|
142
|
+
}
|
|
143
|
+
#error(error) {
|
|
144
|
+
this.#writeFailures++;
|
|
145
|
+
try {
|
|
146
|
+
this.#options.onError?.(error);
|
|
147
|
+
}
|
|
148
|
+
catch { }
|
|
149
|
+
}
|
|
150
|
+
async #persist(event) {
|
|
151
|
+
try {
|
|
152
|
+
await appendFile(join(this.#directory, `${this.attemptId}.jsonl`), `${JSON.stringify(event)}\n`, { mode: 0o600 });
|
|
153
|
+
this.#persisted++;
|
|
154
|
+
}
|
|
155
|
+
catch (error) {
|
|
156
|
+
this.#error(error);
|
|
157
|
+
event.collection = {
|
|
158
|
+
persisted: this.#persisted,
|
|
159
|
+
writeFailures: this.#writeFailures,
|
|
160
|
+
};
|
|
161
|
+
}
|
|
162
|
+
}
|
|
163
|
+
async #emit(type, details = {}) {
|
|
164
|
+
const time = new Date().toISOString();
|
|
165
|
+
const event = {
|
|
166
|
+
schemaVersion: 1,
|
|
167
|
+
eventId: `${this.attemptId}:${type}`,
|
|
168
|
+
...this.context,
|
|
169
|
+
usageScopeId: this.#usageScopeId,
|
|
170
|
+
occurredAt: type === "attempt_started" ? this.#startedAt : time,
|
|
171
|
+
observedAt: time,
|
|
172
|
+
type,
|
|
173
|
+
command: this.#options.command,
|
|
174
|
+
surface: this.#options.surface,
|
|
175
|
+
packageVersion: VERSION,
|
|
176
|
+
...(this.#options.mode === undefined ? {} : { mode: this.#options.mode }),
|
|
177
|
+
resumed: this.#options.resumeScanId !== undefined,
|
|
178
|
+
...details,
|
|
179
|
+
collection: {
|
|
180
|
+
persisted: this.#persisted + (this.#ready ? 1 : 0),
|
|
181
|
+
writeFailures: this.#writeFailures,
|
|
182
|
+
},
|
|
183
|
+
};
|
|
184
|
+
if (this.#ready)
|
|
185
|
+
await this.#persist(event);
|
|
186
|
+
else if (this.#deferred && type === "attempt_started") {
|
|
187
|
+
this.#startedEvent = event;
|
|
188
|
+
// Resume identity is restored only after the caller protects output paths.
|
|
189
|
+
if (this.#options.resumeScanId !== undefined)
|
|
190
|
+
return;
|
|
191
|
+
}
|
|
192
|
+
this.#notify(event);
|
|
193
|
+
}
|
|
194
|
+
#notify(event) {
|
|
195
|
+
// Observers cannot delay or fail the operation. Replay uses the same event ID.
|
|
196
|
+
void Promise.resolve()
|
|
197
|
+
.then(() => this.#options.onEvent?.(event))
|
|
198
|
+
.catch(() => { });
|
|
199
|
+
}
|
|
200
|
+
}
|
|
201
|
+
/** Read durable receipts, retaining explicit evidence of truncated/corrupt records. */
|
|
202
|
+
export async function readOperationTelemetry(stateDirectory) {
|
|
203
|
+
const directory = join(stateDirectory, "telemetry");
|
|
204
|
+
const events = [];
|
|
205
|
+
let parseFailures = 0;
|
|
206
|
+
const names = await readdir(directory).catch((error) => {
|
|
207
|
+
if (error.code === "ENOENT")
|
|
208
|
+
return [];
|
|
209
|
+
throw error;
|
|
210
|
+
});
|
|
211
|
+
for (const name of names.filter((name) => name.endsWith(".jsonl")).sort()) {
|
|
212
|
+
for (const line of (await readFile(join(directory, name), "utf8")).split("\n")) {
|
|
213
|
+
if (!line)
|
|
214
|
+
continue;
|
|
215
|
+
try {
|
|
216
|
+
const event = JSON.parse(line);
|
|
217
|
+
if (event.schemaVersion !== 1 ||
|
|
218
|
+
typeof event.eventId !== "string" ||
|
|
219
|
+
typeof event.attemptId !== "string" ||
|
|
220
|
+
typeof event.operationId !== "string" ||
|
|
221
|
+
typeof event.usageScopeId !== "string" ||
|
|
222
|
+
!["attempt_started", "attempt_finished"].includes(event.type) ||
|
|
223
|
+
((event.type === "attempt_finished" || event.outcome !== undefined) &&
|
|
224
|
+
!["completed", "failed", "canceled", "unresolved"].includes(event.outcome ?? "")) ||
|
|
225
|
+
(event.measurement !== undefined &&
|
|
226
|
+
!["complete", "partial", "unavailable"].includes(event.measurement?.coverage))) {
|
|
227
|
+
parseFailures++;
|
|
228
|
+
}
|
|
229
|
+
else
|
|
230
|
+
events.push(event);
|
|
231
|
+
}
|
|
232
|
+
catch {
|
|
233
|
+
parseFailures++;
|
|
234
|
+
}
|
|
235
|
+
}
|
|
236
|
+
}
|
|
237
|
+
return { events, parseFailures };
|
|
238
|
+
}
|
|
239
|
+
/** Attempts without a terminal receipt remain unresolved, including process loss. */
|
|
240
|
+
export function summarizeOperationTelemetry(events) {
|
|
241
|
+
const seen = new Set();
|
|
242
|
+
const attempts = new Map();
|
|
243
|
+
let duplicates = 0;
|
|
244
|
+
for (const event of events) {
|
|
245
|
+
if (seen.has(event.eventId)) {
|
|
246
|
+
duplicates++;
|
|
247
|
+
continue;
|
|
248
|
+
}
|
|
249
|
+
seen.add(event.eventId);
|
|
250
|
+
const previous = attempts.get(event.attemptId);
|
|
251
|
+
if (previous?.type !== "attempt_finished" ||
|
|
252
|
+
event.type === "attempt_finished")
|
|
253
|
+
attempts.set(event.attemptId, event);
|
|
254
|
+
}
|
|
255
|
+
const operations = new Map();
|
|
256
|
+
const outcomes = { completed: 0, failed: 0, canceled: 0, unresolved: 0 };
|
|
257
|
+
const usageCoverage = { complete: 0, partial: 0, unavailable: 0 };
|
|
258
|
+
const durationMs = [];
|
|
259
|
+
let observedCostUsd = 0;
|
|
260
|
+
let pricedAttempts = 0;
|
|
261
|
+
let reusedAttempts = 0;
|
|
262
|
+
const costsByScope = new Map();
|
|
263
|
+
for (const event of attempts.values()) {
|
|
264
|
+
operations.set(event.operationId, operations.get(event.operationId) === true ||
|
|
265
|
+
event.outcome === "completed");
|
|
266
|
+
outcomes[event.outcome ?? "unresolved"]++;
|
|
267
|
+
if (event.reusedResult === true)
|
|
268
|
+
reusedAttempts++;
|
|
269
|
+
else
|
|
270
|
+
usageCoverage[event.measurement?.coverage ?? "unavailable"]++;
|
|
271
|
+
if (event.durationMs !== undefined)
|
|
272
|
+
durationMs.push(event.durationMs);
|
|
273
|
+
if (event.measurement?.cost != null) {
|
|
274
|
+
costsByScope.set(event.usageScopeId, Math.max(costsByScope.get(event.usageScopeId) ?? 0, event.measurement.cost.estimatedUsd));
|
|
275
|
+
pricedAttempts++;
|
|
276
|
+
}
|
|
277
|
+
}
|
|
278
|
+
for (const cost of costsByScope.values())
|
|
279
|
+
observedCostUsd += cost;
|
|
280
|
+
return {
|
|
281
|
+
operations: operations.size,
|
|
282
|
+
successfulOperations: [...operations.values()].filter(Boolean).length,
|
|
283
|
+
attempts: attempts.size,
|
|
284
|
+
outcomes,
|
|
285
|
+
usageCoverage,
|
|
286
|
+
durationMs,
|
|
287
|
+
observedCostUsd,
|
|
288
|
+
pricedAttempts,
|
|
289
|
+
reusedAttempts,
|
|
290
|
+
duplicates,
|
|
291
|
+
};
|
|
292
|
+
}
|
|
293
|
+
//# sourceMappingURL=operation-telemetry.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"operation-telemetry.js","sourceRoot":"","sources":["../src/operation-telemetry.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash, randomUUID } from \"node:crypto\";\nimport {\n appendFile,\n mkdir,\n readFile,\n readdir,\n writeFile,\n} from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport type { ScanUsageMeasurement } from \"./cost.js\";\nimport {\n canonicalConfigPath,\n requireOutputOutsideRepositories,\n requireSecureOutputAncestry,\n} from \"./runtime.js\";\nimport { gitProtectionRoots } from \"./targets.js\";\nimport { VERSION } from \"./version.js\";\n\nexport type OperationOutcome =\n \"completed\" | \"failed\" | \"canceled\" | \"unresolved\";\nexport type OperationFailureCategory =\n | \"configuration\"\n | \"authentication\"\n | \"input\"\n | \"budget\"\n | \"execution\"\n | \"canceled\";\n\n/** Content-free operational receipts. IDs are for joins, never metric labels. */\nexport interface OperationTelemetryEvent {\n schemaVersion: 1;\n eventId: string;\n operationId: string;\n attemptId: string;\n parentAttemptId?: string;\n /** Resumed scans share a cumulative measurement scope; never sum those receipts. */\n usageScopeId: string;\n occurredAt: string;\n observedAt: string;\n type: \"attempt_started\" | \"attempt_finished\";\n command:\n | \"scan\"\n | \"patch\"\n | \"validate\"\n | \"policy\"\n | \"verify-fix\"\n | \"assess-patch-risk\";\n surface: \"cli\" | \"sdk\";\n packageVersion: string;\n mode?: \"standard\" | \"deep\";\n resumed: boolean;\n /** True when this call returned a saved result without starting new work. */\n reusedResult?: boolean;\n outcome?: OperationOutcome;\n failureCategory?: OperationFailureCategory;\n durationMs?: number;\n measurement?: Readonly<ScanUsageMeasurement>;\n findingCount?: number;\n reviewedSurfaceCount?: number;\n deferredCount?: number;\n pluginVersion?: string;\n providerFamily?: string;\n validationDisposition?:\n \"reportable\" | \"suppressed\" | \"not_applicable\" | \"deferred\";\n artifactComplete?: boolean;\n collection: { persisted: number; writeFailures: number };\n}\n\ninterface OperationTelemetryOptions {\n directory: string;\n protectedRepository?: string;\n protectedOutput?: string;\n command: OperationTelemetryEvent[\"command\"];\n surface: OperationTelemetryEvent[\"surface\"];\n mode?: OperationTelemetryEvent[\"mode\"];\n resumeScanId?: string;\n deferPersistence?: boolean;\n context?: { operationId: string; parentAttemptId?: string };\n onEvent?: (event: Readonly<OperationTelemetryEvent>) => void;\n onError?: (error: unknown) => void;\n}\n\n/** Local journal only. Export, acknowledgement and retention belong to the host. */\nexport class OperationTelemetry {\n readonly attemptId = randomUUID();\n operationId: string;\n measurement: Readonly<ScanUsageMeasurement> | undefined;\n reusedResult = false;\n nativeTurnFailed = false;\n readonly #started = performance.now();\n readonly #startedAt = new Date().toISOString();\n readonly #options: OperationTelemetryOptions;\n readonly #directory: string;\n #persisted = 0;\n #writeFailures = 0;\n #ready = false;\n #runtime: Pick<OperationTelemetryEvent, \"pluginVersion\" | \"providerFamily\"> =\n {};\n #finished = false;\n #usageScopeId: string = this.attemptId;\n #deferred: boolean;\n #startedEvent: OperationTelemetryEvent | undefined;\n\n constructor(options: OperationTelemetryOptions) {\n this.#options = options;\n this.operationId = options.context?.operationId ?? randomUUID();\n this.#directory = join(options.directory, \"telemetry\");\n this.#deferred = options.deferPersistence === true;\n }\n\n get context() {\n return {\n operationId: this.operationId,\n attemptId: this.attemptId,\n ...(this.#options.context?.parentAttemptId === undefined\n ? {}\n : { parentAttemptId: this.#options.context.parentAttemptId }),\n };\n }\n\n async start(): Promise<void> {\n if (!this.#deferred) await this.#preparePersistence();\n await this.#emit(\"attempt_started\");\n }\n\n /** Callers establish repository and artifact protection before any writes. */\n async activatePersistence(\n protectedRoots: readonly string[],\n savedOutput?: string,\n ): Promise<void> {\n if (!this.#deferred || this.#finished) return;\n this.#deferred = false;\n await this.#preparePersistence(protectedRoots, savedOutput);\n if (this.#startedEvent !== undefined) {\n const event = {\n ...this.#startedEvent,\n ...this.context,\n usageScopeId: this.#usageScopeId,\n collection: {\n persisted: this.#persisted + (this.#ready ? 1 : 0),\n writeFailures: this.#writeFailures,\n },\n };\n if (this.#ready) await this.#persist(event);\n if (this.#options.resumeScanId !== undefined) this.#notify(event);\n }\n this.#startedEvent = undefined;\n }\n\n async #preparePersistence(\n additionalRoots: readonly string[] = [],\n savedOutput?: string,\n ): Promise<void> {\n try {\n const protectedRoots = [...additionalRoots];\n for (const output of [this.#options.protectedOutput, savedOutput]) {\n if (output !== undefined)\n protectedRoots.push(await canonicalConfigPath(output));\n }\n if (this.#options.protectedRepository !== undefined) {\n const repository = await canonicalConfigPath(\n this.#options.protectedRepository,\n );\n protectedRoots.push(\n repository,\n ...(await gitProtectionRoots(this.#options.protectedRepository)),\n );\n }\n if (protectedRoots.length > 0) {\n requireOutputOutsideRepositories(\n protectedRoots,\n await canonicalConfigPath(this.#directory),\n \"runtime\",\n );\n }\n await requireSecureOutputAncestry(this.#directory);\n await mkdir(this.#directory, { recursive: true, mode: 0o700 });\n this.#ready = true;\n if (this.#options.resumeScanId !== undefined) {\n try {\n const saved = JSON.parse(\n await readFile(\n this.#bindingPath(this.#options.resumeScanId),\n \"utf8\",\n ),\n ) as { operationId: string; usageScopeId: string };\n this.operationId = saved.operationId;\n this.#usageScopeId = saved.usageScopeId;\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"ENOENT\")\n this.#error(error);\n }\n }\n } catch (error) {\n this.#error(error);\n }\n }\n\n async bindScan(scanId: string): Promise<void> {\n if (!this.#ready) return;\n try {\n await writeFile(\n this.#bindingPath(scanId),\n JSON.stringify({\n ...this.context,\n usageScopeId: this.#usageScopeId,\n }),\n {\n mode: 0o600,\n },\n );\n } catch (error) {\n this.#error(error);\n }\n }\n\n describe(\n runtime: Pick<OperationTelemetryEvent, \"pluginVersion\" | \"providerFamily\">,\n ): void {\n this.#runtime = runtime;\n }\n\n async finish(\n outcome: OperationOutcome,\n details: Pick<\n OperationTelemetryEvent,\n | \"failureCategory\"\n | \"findingCount\"\n | \"artifactComplete\"\n | \"reviewedSurfaceCount\"\n | \"deferredCount\"\n | \"validationDisposition\"\n > = {},\n ): Promise<void> {\n if (this.#finished) return;\n this.#finished = true;\n if (\n this.#startedEvent !== undefined &&\n this.#options.resumeScanId !== undefined\n ) {\n this.#notify(this.#startedEvent);\n this.#startedEvent = undefined;\n }\n await this.#emit(\"attempt_finished\", {\n outcome,\n reusedResult: this.reusedResult,\n durationMs: Math.max(0, performance.now() - this.#started),\n ...(this.measurement === undefined\n ? {}\n : { measurement: this.measurement }),\n ...this.#runtime,\n ...details,\n });\n }\n\n #bindingPath(scanId: string): string {\n return join(\n this.#directory,\n `${createHash(\"sha256\").update(scanId).digest(\"hex\")}.binding.json`,\n );\n }\n\n #error(error: unknown): void {\n this.#writeFailures++;\n try {\n this.#options.onError?.(error);\n } catch {}\n }\n\n async #persist(event: OperationTelemetryEvent): Promise<void> {\n try {\n await appendFile(\n join(this.#directory, `${this.attemptId}.jsonl`),\n `${JSON.stringify(event)}\\n`,\n { mode: 0o600 },\n );\n this.#persisted++;\n } catch (error) {\n this.#error(error);\n event.collection = {\n persisted: this.#persisted,\n writeFailures: this.#writeFailures,\n };\n }\n }\n\n async #emit(\n type: OperationTelemetryEvent[\"type\"],\n details: Partial<OperationTelemetryEvent> = {},\n ): Promise<void> {\n const time = new Date().toISOString();\n const event: OperationTelemetryEvent = {\n schemaVersion: 1,\n eventId: `${this.attemptId}:${type}`,\n ...this.context,\n usageScopeId: this.#usageScopeId,\n occurredAt: type === \"attempt_started\" ? this.#startedAt : time,\n observedAt: time,\n type,\n command: this.#options.command,\n surface: this.#options.surface,\n packageVersion: VERSION,\n ...(this.#options.mode === undefined ? {} : { mode: this.#options.mode }),\n resumed: this.#options.resumeScanId !== undefined,\n ...details,\n collection: {\n persisted: this.#persisted + (this.#ready ? 1 : 0),\n writeFailures: this.#writeFailures,\n },\n };\n if (this.#ready) await this.#persist(event);\n else if (this.#deferred && type === \"attempt_started\") {\n this.#startedEvent = event;\n // Resume identity is restored only after the caller protects output paths.\n if (this.#options.resumeScanId !== undefined) return;\n }\n this.#notify(event);\n }\n\n #notify(event: OperationTelemetryEvent): void {\n // Observers cannot delay or fail the operation. Replay uses the same event ID.\n void Promise.resolve()\n .then(() => this.#options.onEvent?.(event))\n .catch(() => {});\n }\n}\n\n/** Read durable receipts, retaining explicit evidence of truncated/corrupt records. */\nexport async function readOperationTelemetry(stateDirectory: string): Promise<{\n events: OperationTelemetryEvent[];\n parseFailures: number;\n}> {\n const directory = join(stateDirectory, \"telemetry\");\n const events: OperationTelemetryEvent[] = [];\n let parseFailures = 0;\n const names = await readdir(directory).catch(\n (error: NodeJS.ErrnoException) => {\n if (error.code === \"ENOENT\") return [];\n throw error;\n },\n );\n for (const name of names.filter((name) => name.endsWith(\".jsonl\")).sort()) {\n for (const line of (await readFile(join(directory, name), \"utf8\")).split(\n \"\\n\",\n )) {\n if (!line) continue;\n try {\n const event = JSON.parse(line) as OperationTelemetryEvent;\n if (\n event.schemaVersion !== 1 ||\n typeof event.eventId !== \"string\" ||\n typeof event.attemptId !== \"string\" ||\n typeof event.operationId !== \"string\" ||\n typeof event.usageScopeId !== \"string\" ||\n ![\"attempt_started\", \"attempt_finished\"].includes(event.type) ||\n ((event.type === \"attempt_finished\" || event.outcome !== undefined) &&\n ![\"completed\", \"failed\", \"canceled\", \"unresolved\"].includes(\n event.outcome ?? \"\",\n )) ||\n (event.measurement !== undefined &&\n ![\"complete\", \"partial\", \"unavailable\"].includes(\n event.measurement?.coverage,\n ))\n ) {\n parseFailures++;\n } else events.push(event);\n } catch {\n parseFailures++;\n }\n }\n }\n return { events, parseFailures };\n}\n\n/** Attempts without a terminal receipt remain unresolved, including process loss. */\nexport function summarizeOperationTelemetry(\n events: readonly OperationTelemetryEvent[],\n) {\n const seen = new Set<string>();\n const attempts = new Map<string, OperationTelemetryEvent>();\n let duplicates = 0;\n for (const event of events) {\n if (seen.has(event.eventId)) {\n duplicates++;\n continue;\n }\n seen.add(event.eventId);\n const previous = attempts.get(event.attemptId);\n if (\n previous?.type !== \"attempt_finished\" ||\n event.type === \"attempt_finished\"\n )\n attempts.set(event.attemptId, event);\n }\n const operations = new Map<string, boolean>();\n const outcomes = { completed: 0, failed: 0, canceled: 0, unresolved: 0 };\n const usageCoverage = { complete: 0, partial: 0, unavailable: 0 };\n const durationMs: number[] = [];\n let observedCostUsd = 0;\n let pricedAttempts = 0;\n let reusedAttempts = 0;\n const costsByScope = new Map<string, number>();\n for (const event of attempts.values()) {\n operations.set(\n event.operationId,\n operations.get(event.operationId) === true ||\n event.outcome === \"completed\",\n );\n outcomes[event.outcome ?? \"unresolved\"]++;\n if (event.reusedResult === true) reusedAttempts++;\n else usageCoverage[event.measurement?.coverage ?? \"unavailable\"]++;\n if (event.durationMs !== undefined) durationMs.push(event.durationMs);\n if (event.measurement?.cost != null) {\n costsByScope.set(\n event.usageScopeId,\n Math.max(\n costsByScope.get(event.usageScopeId) ?? 0,\n event.measurement.cost.estimatedUsd,\n ),\n );\n pricedAttempts++;\n }\n }\n for (const cost of costsByScope.values()) observedCostUsd += cost;\n return {\n operations: operations.size,\n successfulOperations: [...operations.values()].filter(Boolean).length,\n attempts: attempts.size,\n outcomes,\n usageCoverage,\n durationMs,\n observedCostUsd,\n pricedAttempts,\n reusedAttempts,\n duplicates,\n };\n}\n"]}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"plugin-python-probe.d.ts","sourceRoot":"","sources":["../src/plugin-python-probe.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,6BAA6B,CAAC;AAE9D,eAAO,MAAM,8BAA8B,QAAS,CAAC;AAErD,eAAO,MAAM,mBAAmB,QAKpB,CAAC"}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
export const PLUGIN_PYTHON_READY = "codex-security-python-ok";
|
|
2
|
+
// Cold Python startup can exceed five seconds on busy Windows hosts.
|
|
3
|
+
export const PLUGIN_PYTHON_PROBE_TIMEOUT_MS = 30_000;
|
|
4
|
+
export const PLUGIN_PYTHON_PROBE = [
|
|
5
|
+
"import importlib.util,sys",
|
|
6
|
+
"if sys.version_info < (3, 10): raise SystemExit(1)",
|
|
7
|
+
"if sys.version_info < (3, 11) and importlib.util.find_spec('tomli') is None: raise SystemExit(1)",
|
|
8
|
+
`print('${PLUGIN_PYTHON_READY}')`,
|
|
9
|
+
].join("\n");
|
|
10
|
+
//# sourceMappingURL=plugin-python-probe.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"plugin-python-probe.js","sourceRoot":"","sources":["../src/plugin-python-probe.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG,0BAA0B,CAAC;AAC9D,qEAAqE;AACrE,MAAM,CAAC,MAAM,8BAA8B,GAAG,MAAM,CAAC;AAErD,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,2BAA2B;IAC3B,oDAAoD;IACpD,kGAAkG;IAClG,UAAU,mBAAmB,IAAI;CAClC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC","sourcesContent":["export const PLUGIN_PYTHON_READY = \"codex-security-python-ok\";\n// Cold Python startup can exceed five seconds on busy Windows hosts.\nexport const PLUGIN_PYTHON_PROBE_TIMEOUT_MS = 30_000;\n\nexport const PLUGIN_PYTHON_PROBE = [\n \"import importlib.util,sys\",\n \"if sys.version_info < (3, 10): raise SystemExit(1)\",\n \"if sys.version_info < (3, 11) and importlib.util.find_spec('tomli') is None: raise SystemExit(1)\",\n `print('${PLUGIN_PYTHON_READY}')`,\n].join(\"\\n\");\n"]}
|