@openai/codex-security 0.9.1 → 0.10.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 +37 -788
- package/_bundled_plugin/.codex-plugin/plugin.json +2 -0
- package/_bundled_plugin/.mcp.json +2 -0
- package/_bundled_plugin/mcp/helpers.mjs.br +0 -0
- 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/server.mjs.br +0 -0
- package/_bundled_plugin/references/artifact-storage.md +1 -1
- package/_bundled_plugin/references/baseline-auditor.md +18 -0
- package/_bundled_plugin/references/core-scan.md +5 -42
- package/_bundled_plugin/references/final-report.md +1 -1
- package/_bundled_plugin/references/focused-investigator.md +13 -0
- package/_bundled_plugin/references/scan-prologue.md +2 -2
- package/_bundled_plugin/references/scan-runtime.md +4 -2
- package/_bundled_plugin/references/security-guidance.md +14 -1
- package/_bundled_plugin/references/validate-scan-findings.md +3 -0
- package/_bundled_plugin/scripts/deep_scan_workbench.py +29 -12
- package/_bundled_plugin/scripts/dispatch_inventory_tool +7 -0
- package/_bundled_plugin/scripts/finalize_scan_contract.py +29 -3
- package/_bundled_plugin/scripts/launch_codex_security_mcp +54 -16
- package/_bundled_plugin/scripts/posix_scan_local_files.py +26 -1
- package/_bundled_plugin/scripts/snapshot_sqlite.py +8 -2
- package/_bundled_plugin/scripts/windows_scan_local_files.py +216 -25
- package/_bundled_plugin/scripts/workbench/handoff.py +55 -25
- package/_bundled_plugin/scripts/workbench/storage.py +25 -5
- package/_bundled_plugin/scripts/workbench_cli.py +24 -2
- package/_bundled_plugin/scripts/workbench_constants.py +2 -0
- package/_bundled_plugin/scripts/workbench_db.py +244 -217
- package/_bundled_plugin/scripts/workbench_feedback.py +49 -4
- package/_bundled_plugin/scripts/workbench_native_indexes.py +226 -29
- package/_bundled_plugin/scripts/workbench_progress.py +159 -3
- package/_bundled_plugin/scripts/workbench_publication.py +2 -3
- package/_bundled_plugin/scripts/workbench_remediation.py +142 -2
- package/_bundled_plugin/scripts/workbench_saved_results.py +48 -8
- package/_bundled_plugin/scripts/workbench_scan_history.py +281 -119
- package/_bundled_plugin/scripts/workbench_scan_start.py +143 -9
- package/_bundled_plugin/scripts/workbench_scan_usage.py +36 -10
- package/_bundled_plugin/scripts/workbench_schema.py +220 -14
- package/_bundled_plugin/scripts/workbench_setup.py +1 -1
- package/_bundled_plugin/scripts/workbench_target.py +471 -84
- package/_bundled_plugin/scripts/workbench_target_state.py +1108 -22
- package/_bundled_plugin/shared/workbench-history-repairs.json +60 -14
- package/_bundled_plugin/shared/workbench-migrations.json +66 -0
- package/_bundled_plugin/skills/fix-finding/SKILL.md +1 -0
- package/_bundled_plugin/skills/publish-findings/SKILL.md +24 -160
- package/_bundled_plugin/skills/publish-findings/agents/openai.yaml +2 -2
- package/_bundled_plugin/skills/publish-findings/references/checkmarx-import.md +2 -2
- package/_bundled_plugin/skills/publish-findings/scripts/collect_checkmarx.py +3 -58
- package/_bundled_plugin/skills/publish-findings/scripts/collect_continuum.py +224 -0
- package/_bundled_plugin/skills/publish-findings/scripts/collector_paths.py +63 -0
- package/_bundled_plugin/skills/security-scan/SKILL.md +9 -46
- package/_bundled_plugin/skills/security-scan/agents/openai.yaml +2 -2
- package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +3 -21
- package/_bundled_plugin/skills/security-scan/references/managed-scan.md +11 -0
- package/_bundled_plugin/skills/security-scan/references/scan-results.md +15 -0
- package/_bundled_plugin/skills/security-scan/references/scoped-paths.md +23 -0
- package/_bundled_plugin/skills/security-scan/references/sdk-files.md +24 -0
- package/bin/codex-security.mjs +2 -2
- package/dist/api.d.ts +6 -1
- package/dist/api.d.ts.map +1 -1
- package/dist/api.js +437 -154
- package/dist/api.js.map +1 -1
- package/dist/armorcode-findings.d.ts +9 -0
- package/dist/armorcode-findings.d.ts.map +1 -0
- package/dist/armorcode-findings.js +145 -0
- package/dist/armorcode-findings.js.map +1 -0
- package/dist/artifact-export.d.ts +2 -0
- package/dist/artifact-export.d.ts.map +1 -1
- package/dist/artifact-export.js +29 -13
- package/dist/artifact-export.js.map +1 -1
- package/dist/auth.d.ts +6 -2
- package/dist/auth.d.ts.map +1 -1
- package/dist/auth.js +33 -12
- package/dist/auth.js.map +1 -1
- package/dist/batch-cost.d.ts +18 -0
- package/dist/batch-cost.d.ts.map +1 -0
- package/dist/batch-cost.js +41 -0
- package/dist/batch-cost.js.map +1 -0
- package/dist/blackduck-findings.d.ts +1 -1
- package/dist/blackduck-findings.d.ts.map +1 -1
- package/dist/blackduck-findings.js +5 -18
- package/dist/blackduck-findings.js.map +1 -1
- package/dist/bundled-plugin.d.ts +4 -0
- package/dist/bundled-plugin.d.ts.map +1 -0
- package/dist/bundled-plugin.js +23 -0
- package/dist/bundled-plugin.js.map +1 -0
- package/dist/classify-scan-severity.d.ts +1 -1
- package/dist/classify-scan-severity.d.ts.map +1 -1
- package/dist/classify-scan-severity.js +11 -3
- package/dist/classify-scan-severity.js.map +1 -1
- package/dist/classify-severity.d.ts.map +1 -1
- package/dist/classify-severity.js +9 -6
- package/dist/classify-severity.js.map +1 -1
- package/dist/cli-argument.d.ts +4 -0
- package/dist/cli-argument.d.ts.map +1 -0
- package/dist/cli-argument.js +17 -0
- package/dist/cli-argument.js.map +1 -0
- package/dist/cli-help.d.ts +1 -1
- package/dist/cli-help.d.ts.map +1 -1
- package/dist/cli-help.js +71 -29
- package/dist/cli-help.js.map +1 -1
- package/dist/cli-hook.d.ts +3 -0
- package/dist/cli-hook.d.ts.map +1 -0
- package/dist/cli-hook.js +87 -0
- package/dist/cli-hook.js.map +1 -0
- package/dist/cli-integrations.d.ts +13 -0
- package/dist/cli-integrations.d.ts.map +1 -0
- package/dist/cli-integrations.js +333 -0
- package/dist/cli-integrations.js.map +1 -0
- package/dist/cli-mcp.d.ts +15 -0
- package/dist/cli-mcp.d.ts.map +1 -0
- package/dist/cli-mcp.js +178 -0
- package/dist/cli-mcp.js.map +1 -0
- package/dist/cli-token-view.d.ts +10 -0
- package/dist/cli-token-view.d.ts.map +1 -0
- package/dist/cli-token-view.js +41 -0
- package/dist/cli-token-view.js.map +1 -0
- package/dist/cli.d.ts +5 -3
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +1763 -894
- package/dist/cli.js.map +1 -1
- package/dist/cloud-publish.d.ts.map +1 -1
- package/dist/cloud-publish.js +33 -31
- package/dist/cloud-publish.js.map +1 -1
- package/dist/codex-sdk-environment.d.ts +6 -0
- package/dist/codex-sdk-environment.d.ts.map +1 -1
- package/dist/codex-sdk-environment.js +19 -0
- package/dist/codex-sdk-environment.js.map +1 -1
- package/dist/command-words.d.ts +3 -0
- package/dist/command-words.d.ts.map +1 -0
- package/dist/command-words.js +46 -0
- package/dist/command-words.js.map +1 -0
- package/dist/component-scan.d.ts +3 -1
- package/dist/component-scan.d.ts.map +1 -1
- package/dist/component-scan.js +40 -7
- package/dist/component-scan.js.map +1 -1
- package/dist/config.d.ts +1 -1
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +30 -1
- package/dist/config.js.map +1 -1
- package/dist/continuum-findings.d.ts +1 -1
- package/dist/continuum-findings.d.ts.map +1 -1
- package/dist/continuum-findings.js +93 -31
- package/dist/continuum-findings.js.map +1 -1
- package/dist/cost.d.ts.map +1 -1
- package/dist/cost.js +1 -45
- package/dist/cost.js.map +1 -1
- package/dist/custom-validation-prompt.d.ts +1 -1
- package/dist/custom-validation-prompt.d.ts.map +1 -1
- package/dist/custom-validation-prompt.js +29 -19
- package/dist/custom-validation-prompt.js.map +1 -1
- package/dist/deduplication/local.d.ts +3 -1
- package/dist/deduplication/local.d.ts.map +1 -1
- package/dist/deduplication/local.js +8 -1
- package/dist/deduplication/local.js.map +1 -1
- package/dist/deduplication/refusal.d.ts.map +1 -1
- package/dist/deduplication/refusal.js +2 -1
- package/dist/deduplication/refusal.js.map +1 -1
- package/dist/deduplication/scan.d.ts +2 -0
- package/dist/deduplication/scan.d.ts.map +1 -1
- package/dist/deduplication/scan.js +24 -7
- package/dist/deduplication/scan.js.map +1 -1
- package/dist/deep-scan.d.ts.map +1 -1
- package/dist/deep-scan.js +16 -15
- package/dist/deep-scan.js.map +1 -1
- package/dist/endor-findings.d.ts +2 -2
- package/dist/endor-findings.d.ts.map +1 -1
- package/dist/endor-findings.js +6 -23
- package/dist/endor-findings.js.map +1 -1
- package/dist/errors.d.ts +3 -1
- package/dist/errors.d.ts.map +1 -1
- package/dist/errors.js +7 -3
- package/dist/errors.js.map +1 -1
- package/dist/executable-path.d.ts +3 -0
- package/dist/executable-path.d.ts.map +1 -1
- package/dist/executable-path.js +26 -0
- package/dist/executable-path.js.map +1 -1
- package/dist/external-findings-import.d.ts.map +1 -1
- package/dist/external-findings-import.js +12 -1
- package/dist/external-findings-import.js.map +1 -1
- package/dist/external-findings-local.d.ts +66 -4
- package/dist/external-findings-local.d.ts.map +1 -1
- package/dist/external-findings-local.js +234 -53
- package/dist/external-findings-local.js.map +1 -1
- package/dist/external-findings-publish.d.ts +6 -1
- package/dist/external-findings-publish.d.ts.map +1 -1
- package/dist/external-findings-publish.js +326 -1633
- package/dist/external-findings-publish.js.map +1 -1
- package/dist/external-findings-read.d.ts +1 -0
- package/dist/external-findings-read.d.ts.map +1 -1
- package/dist/external-findings-read.js +31 -51
- package/dist/external-findings-read.js.map +1 -1
- package/dist/external-findings.d.ts +1 -1
- package/dist/external-findings.d.ts.map +1 -1
- package/dist/external-findings.js +12 -1
- package/dist/external-findings.js.map +1 -1
- package/dist/external-import-contract.d.ts +3 -11
- package/dist/external-import-contract.d.ts.map +1 -1
- package/dist/external-import-contract.js +29 -176
- 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/finding-prompt.d.ts.map +1 -1
- package/dist/finding-prompt.js +2 -2
- package/dist/finding-prompt.js.map +1 -1
- package/dist/github-dependabot-findings.d.ts.map +1 -1
- package/dist/github-dependabot-findings.js +3 -4
- package/dist/github-dependabot-findings.js.map +1 -1
- package/dist/github-findings.d.ts.map +1 -1
- package/dist/github-findings.js +19 -287
- package/dist/github-findings.js.map +1 -1
- package/dist/hosted-remediation.d.ts +1 -0
- package/dist/hosted-remediation.d.ts.map +1 -1
- package/dist/hosted-remediation.js +23 -3
- package/dist/hosted-remediation.js.map +1 -1
- package/dist/index.d.ts +3 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -1
- package/dist/index.js.map +1 -1
- package/dist/inspector-findings.d.ts.map +1 -1
- package/dist/inspector-findings.js +19 -35
- package/dist/inspector-findings.js.map +1 -1
- package/dist/knowledge-base.d.ts +1 -1
- package/dist/knowledge-base.d.ts.map +1 -1
- package/dist/knowledge-base.js +34 -27
- package/dist/knowledge-base.js.map +1 -1
- package/dist/linear.d.ts +11 -0
- package/dist/linear.d.ts.map +1 -1
- package/dist/linear.js.map +1 -1
- package/dist/local-git-metadata.d.ts +5 -2
- package/dist/local-git-metadata.d.ts.map +1 -1
- package/dist/local-git-metadata.js +8 -4
- package/dist/local-git-metadata.js.map +1 -1
- package/dist/multiscan.d.ts +4 -0
- package/dist/multiscan.d.ts.map +1 -1
- package/dist/multiscan.js +79 -37
- package/dist/multiscan.js.map +1 -1
- package/dist/opengrep-findings.d.ts +4 -2
- package/dist/opengrep-findings.d.ts.map +1 -1
- package/dist/opengrep-findings.js +39 -22
- package/dist/opengrep-findings.js.map +1 -1
- package/dist/private-finding-import.d.ts +8 -13
- package/dist/private-finding-import.d.ts.map +1 -1
- package/dist/private-finding-import.js +69 -129
- package/dist/private-finding-import.js.map +1 -1
- package/dist/project-config.d.ts.map +1 -1
- package/dist/project-config.js +53 -13
- package/dist/project-config.js.map +1 -1
- package/dist/prompt-files.d.ts +7 -2
- package/dist/prompt-files.d.ts.map +1 -1
- package/dist/prompt-files.js +42 -20
- package/dist/prompt-files.js.map +1 -1
- package/dist/provider-profile.d.ts.map +1 -1
- package/dist/provider-profile.js +4 -9
- package/dist/provider-profile.js.map +1 -1
- package/dist/publication.d.ts +1 -1
- package/dist/publication.d.ts.map +1 -1
- package/dist/publication.js.map +1 -1
- package/dist/record.d.ts +1 -5
- package/dist/record.d.ts.map +1 -1
- package/dist/record.js +3 -51
- package/dist/record.js.map +1 -1
- package/dist/remediation.d.ts.map +1 -1
- package/dist/remediation.js +3 -1
- package/dist/remediation.js.map +1 -1
- package/dist/runtime.d.ts +35 -7
- package/dist/runtime.d.ts.map +1 -1
- package/dist/runtime.js +778 -153
- package/dist/runtime.js.map +1 -1
- package/dist/saved-scan-bootstrap.d.ts +6 -1
- package/dist/saved-scan-bootstrap.d.ts.map +1 -1
- package/dist/saved-scan-bootstrap.js +267 -115
- package/dist/saved-scan-bootstrap.js.map +1 -1
- package/dist/scan-archive-path.d.ts +2 -0
- package/dist/scan-archive-path.d.ts.map +1 -0
- package/dist/scan-archive-path.js +5 -0
- package/dist/scan-archive-path.js.map +1 -0
- package/dist/scan-comparison.d.ts.map +1 -1
- package/dist/scan-comparison.js +6 -2
- package/dist/scan-comparison.js.map +1 -1
- package/dist/scan-dashboard.d.ts +1 -0
- package/dist/scan-dashboard.d.ts.map +1 -1
- package/dist/scan-dashboard.js +18 -2
- package/dist/scan-dashboard.js.map +1 -1
- package/dist/scan-executor.d.ts.map +1 -1
- package/dist/scan-executor.js +4 -2
- package/dist/scan-executor.js.map +1 -1
- package/dist/scan-history-renderer.d.ts +1 -0
- package/dist/scan-history-renderer.d.ts.map +1 -1
- package/dist/scan-history-renderer.js +25 -9
- package/dist/scan-history-renderer.js.map +1 -1
- package/dist/scan-logs.d.ts.map +1 -1
- package/dist/scan-logs.js +28 -4
- package/dist/scan-logs.js.map +1 -1
- package/dist/scanner-import.d.ts +5 -11
- package/dist/scanner-import.d.ts.map +1 -1
- package/dist/scanner-import.js +16 -89
- package/dist/scanner-import.js.map +1 -1
- package/dist/security-policy.d.ts.map +1 -1
- package/dist/security-policy.js +26 -6
- package/dist/security-policy.js.map +1 -1
- package/dist/semgrep-findings.d.ts.map +1 -1
- package/dist/semgrep-findings.js +14 -48
- package/dist/semgrep-findings.js.map +1 -1
- package/dist/semgrep-platform-findings.d.ts +20 -70
- package/dist/semgrep-platform-findings.d.ts.map +1 -1
- package/dist/semgrep-platform-findings.js +116 -333
- package/dist/semgrep-platform-findings.js.map +1 -1
- package/dist/snyk-findings.d.ts +2 -0
- package/dist/snyk-findings.d.ts.map +1 -1
- package/dist/snyk-findings.js +5 -8
- package/dist/snyk-findings.js.map +1 -1
- package/dist/snyk-rest-findings.d.ts +3 -20
- package/dist/snyk-rest-findings.d.ts.map +1 -1
- package/dist/snyk-rest-findings.js +45 -217
- package/dist/snyk-rest-findings.js.map +1 -1
- package/dist/sonar-findings.d.ts +1 -1
- package/dist/sonar-findings.d.ts.map +1 -1
- package/dist/sonar-findings.js +2 -4
- package/dist/sonar-findings.js.map +1 -1
- package/dist/sonar-import.d.ts +3 -0
- package/dist/sonar-import.d.ts.map +1 -1
- package/dist/sonar-import.js +28 -30
- package/dist/sonar-import.js.map +1 -1
- package/dist/stored-finding-projection.d.ts +6 -0
- package/dist/stored-finding-projection.d.ts.map +1 -0
- package/dist/stored-finding-projection.js +104 -0
- package/dist/stored-finding-projection.js.map +1 -0
- package/dist/stored-findings-publication.d.ts +23 -0
- package/dist/stored-findings-publication.d.ts.map +1 -0
- package/dist/stored-findings-publication.js +169 -0
- package/dist/stored-findings-publication.js.map +1 -0
- package/dist/targets.d.ts +6 -1
- package/dist/targets.d.ts.map +1 -1
- package/dist/targets.js +76 -23
- package/dist/targets.js.map +1 -1
- package/dist/tenable-findings.d.ts +1 -4
- package/dist/tenable-findings.d.ts.map +1 -1
- package/dist/tenable-findings.js.map +1 -1
- package/dist/trivy-findings.d.ts.map +1 -1
- package/dist/trivy-findings.js +0 -11
- package/dist/trivy-findings.js.map +1 -1
- package/dist/trusted-executable.d.ts +6 -0
- package/dist/trusted-executable.d.ts.map +1 -1
- package/dist/trusted-executable.js +140 -37
- package/dist/trusted-executable.js.map +1 -1
- package/dist/veracode-findings.d.ts +1 -3
- package/dist/veracode-findings.d.ts.map +1 -1
- package/dist/veracode-findings.js +13 -38
- package/dist/veracode-findings.js.map +1 -1
- package/dist/version.d.ts +3 -1
- package/dist/version.d.ts.map +1 -1
- package/dist/version.js +184 -32
- package/dist/version.js.map +1 -1
- package/dist/wiz-findings.d.ts +2 -2
- package/dist/wiz-findings.d.ts.map +1 -1
- package/dist/wiz-findings.js +14 -92
- package/dist/wiz-findings.js.map +1 -1
- package/docs/cli.md +373 -106
- package/docs/findings-service.md +22 -9
- package/docs/hosted-remediation.md +13 -4
- package/docs/sdk.md +903 -0
- package/package.json +10 -6
- package/schemas/external-findings.schema.json +2 -1
- package/dist/hosted-scanner-v1.d.ts +0 -6
- package/dist/hosted-scanner-v1.d.ts.map +0 -1
- package/dist/hosted-scanner-v1.js +0 -60
- package/dist/hosted-scanner-v1.js.map +0 -1
- package/dist/reader-selection.d.ts +0 -15
- package/dist/reader-selection.d.ts.map +0 -1
- package/dist/reader-selection.js +0 -89
- package/dist/reader-selection.js.map +0 -1
- package/dist/semgrep-platform-v1.d.ts +0 -6
- package/dist/semgrep-platform-v1.d.ts.map +0 -1
- package/dist/semgrep-platform-v1.js +0 -83
- package/dist/semgrep-platform-v1.js.map +0 -1
- package/dist/snyk-rest-v1.d.ts +0 -28
- package/dist/snyk-rest-v1.d.ts.map +0 -1
- package/dist/snyk-rest-v1.js +0 -132
- package/dist/snyk-rest-v1.js.map +0 -1
|
@@ -4,7 +4,7 @@ import { findingEntry } from "./value.js";
|
|
|
4
4
|
import { z } from "zod";
|
|
5
5
|
import { CodexSecurityError } from "./errors.js";
|
|
6
6
|
import { workflowDigest } from "./finding-workflow.js";
|
|
7
|
-
import {
|
|
7
|
+
import { readKnowledgeBaseSnapshot } from "./knowledge-base.js";
|
|
8
8
|
import { runReadOnlyCodex, } from "./scan-comparison.js";
|
|
9
9
|
import { severityDecisionSchema as decisionSchema, severityReviewInstructions, parseSeverityDecision, reviewSeverity, classificationRunsSchema, reviewRunsOption, } from "./severity-review.js";
|
|
10
10
|
import { CODEX_SECURITY_THREAD_SOURCES } from "./thread-source.js";
|
|
@@ -32,7 +32,7 @@ export async function classifySeverity(findings, options = {}) {
|
|
|
32
32
|
return classifySeverityInternal(findings, options);
|
|
33
33
|
}
|
|
34
34
|
/** @internal */
|
|
35
|
-
export async function classifySeverityInternal(findings, options = {}, surface = "sdk", checkpoint) {
|
|
35
|
+
export async function classifySeverityInternal(findings, options = {}, surface = "sdk", checkpoint, roots) {
|
|
36
36
|
options.signal?.throwIfAborted();
|
|
37
37
|
const classificationRuns = reviewRunsOption.parse(options.classificationRuns);
|
|
38
38
|
const ids = new Set();
|
|
@@ -49,10 +49,10 @@ export async function classifySeverityInternal(findings, options = {}, surface =
|
|
|
49
49
|
rubric = [defaultRubric.markdown];
|
|
50
50
|
}
|
|
51
51
|
else {
|
|
52
|
-
rubric = await readDocuments([options.rubricPath], options.signal);
|
|
52
|
+
rubric = await readDocuments([options.rubricPath], options.signal, roots);
|
|
53
53
|
}
|
|
54
54
|
const knowledge = options.knowledgeBasePaths?.length
|
|
55
|
-
? await readDocuments(options.knowledgeBasePaths, options.signal)
|
|
55
|
+
? await readDocuments(options.knowledgeBasePaths, options.signal, roots)
|
|
56
56
|
: null;
|
|
57
57
|
const rubricCheckpointSha256 = workflowDigest(rubric);
|
|
58
58
|
const metadata = {
|
|
@@ -117,8 +117,11 @@ export async function classifySeverityInternal(findings, options = {}, surface =
|
|
|
117
117
|
options.signal?.throwIfAborted();
|
|
118
118
|
return result;
|
|
119
119
|
}
|
|
120
|
-
async function readDocuments(paths, signal) {
|
|
121
|
-
const
|
|
120
|
+
async function readDocuments(paths, signal, roots) {
|
|
121
|
+
const { documents } = await readKnowledgeBaseSnapshot(paths, signal, roots);
|
|
122
|
+
const contents = Object.keys(documents)
|
|
123
|
+
.sort()
|
|
124
|
+
.map((name) => documents[name]);
|
|
122
125
|
if (contents.every((text) => !text.trim())) {
|
|
123
126
|
throw new CodexSecurityError("Classification documents must not be empty.");
|
|
124
127
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"classify-severity.js","sourceRoot":"","sources":["../src/classify-severity.ts"],"names":[],"mappings":"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","sourcesContent":["import { hash } from \"node:crypto\";\nimport {\n getDefaultSeverityRubric,\n type SeverityRubricSnapshot,\n} from \"./severity-rubric.js\";\nimport { findingEntry } from \"./value.js\";\nimport { z } from \"zod\";\nimport { CodexSecurityError } from \"./errors.js\";\nimport { workflowDigest } from \"./finding-workflow.js\";\nimport { readKnowledgeBaseDocuments } from \"./knowledge-base.js\";\nimport type { Finding } from \"./models.js\";\nimport {\n runReadOnlyCodex,\n type ReadOnlyCodexOptions,\n} from \"./scan-comparison.js\";\nimport {\n severityDecisionSchema as decisionSchema,\n severityReviewInstructions,\n parseSeverityDecision,\n reviewSeverity,\n classificationRunsSchema,\n reviewRunsOption,\n} from \"./severity-review.js\";\nimport { CODEX_SECURITY_THREAD_SOURCES } from \"./thread-source.js\";\n\n/** Full reports and explicitly supplied context from any finding source. */\nexport type SeverityClassificationFinding = Pick<\n Finding,\n \"findingId\" | \"title\" | \"summary\"\n> &\n Partial<Pick<Finding, \"occurrenceId\" | \"severity\">> &\n Record<string, unknown>;\n\nexport interface ClassifySeverityOptions extends Pick<\n ReadOnlyCodexOptions,\n | \"config\"\n | \"environment\"\n | \"model\"\n | \"reasoningEffort\"\n | \"signal\"\n | \"workingDirectory\"\n> {\n /** Overrides both the bundled default and the optional remote default. */\n rubricPath?: string;\n /** Independent reviews per finding: integer 1–10, default 3. */\n classificationRuns?: number;\n /** Supporting evidence, separate from classification policy. */\n knowledgeBasePaths?: readonly string[];\n /** @internal Test client for the shared read-only runtime. */\n codex?: ReadOnlyCodexOptions[\"codex\"];\n}\n\nexport interface SeverityAssessment extends z.infer<typeof decisionSchema> {\n occurrenceId: string | null;\n inputSha256: string;\n source: \"existing-severity\" | \"rubric\";\n}\n\nexport interface SeverityClassification {\n schemaVersion: 1;\n assessedAt: string;\n /** Absent on legacy results whose review count was not recorded. */\n classificationRuns?: number;\n /** SHA-256 of the exact policy text, or the ordered document digest for collections and legacy results. */\n rubricSha256: string | null;\n /** Revision of the bundled or remote rubric. Unversioned file inputs and legacy results omit it. */\n rubricRevision?: number;\n knowledgeBaseSha256: string | null;\n assessments: SeverityAssessment[];\n}\n\n/** @internal Document collections retain their original checkpoint key. */\nexport type SeverityClassificationBinding = Omit<\n SeverityClassification,\n \"assessments\"\n> & {\n rubricCheckpointSha256: string | null;\n};\n\n/** @internal Per-finding persistence used by saved-scan classification. */\nexport interface SeverityClassificationCheckpoint {\n load(binding: SeverityClassificationBinding): Promise<SeverityAssessment[]>;\n save(\n finding: SeverityClassificationFinding,\n assessment: SeverityAssessment,\n binding: SeverityClassificationBinding,\n ): Promise<void>;\n}\n\nconst textSchema = z\n .string()\n .min(1)\n .refine((value) => value.trim().length > 0);\nconst digestSchema = z.string().regex(/^[a-f0-9]{64}$/u);\n/** @internal */\nexport const severityClassificationSchema = z.strictObject({\n schemaVersion: z.literal(1),\n assessedAt: z.string().datetime(),\n classificationRuns: classificationRunsSchema.optional(),\n rubricSha256: digestSchema.nullable(),\n rubricRevision: z.number().int().positive().optional(),\n knowledgeBaseSha256: digestSchema.nullable(),\n assessments: z.array(\n decisionSchema.extend({\n occurrenceId: textSchema.nullable(),\n inputSha256: digestSchema,\n source: z.enum([\"existing-severity\", \"rubric\"]),\n }),\n ),\n}) satisfies z.ZodType<SeverityClassification>;\n\n/** Classify each supplied report independently, without scanning or writing findings. */\nexport async function classifySeverity(\n findings: readonly SeverityClassificationFinding[],\n options: ClassifySeverityOptions = {},\n): Promise<SeverityClassification> {\n return classifySeverityInternal(findings, options);\n}\n\n/** @internal */\nexport async function classifySeverityInternal(\n findings: readonly SeverityClassificationFinding[],\n options: ClassifySeverityOptions = {},\n surface: \"sdk\" | \"cli\" = \"sdk\",\n checkpoint?: SeverityClassificationCheckpoint,\n): Promise<SeverityClassification> {\n options.signal?.throwIfAborted();\n const classificationRuns = reviewRunsOption.parse(options.classificationRuns);\n const ids = new Set<string>();\n for (const finding of findings) {\n if (!finding.findingId?.trim() || ids.has(finding.findingId)) {\n throw new CodexSecurityError(\n \"Severity classification requires unique finding IDs.\",\n );\n }\n ids.add(finding.findingId);\n }\n let rubric: string[];\n let defaultRubric: SeverityRubricSnapshot | undefined;\n if (options.rubricPath === undefined) {\n defaultRubric = await getDefaultSeverityRubric(options);\n rubric = [defaultRubric.markdown];\n } else {\n rubric = await readDocuments([options.rubricPath], options.signal);\n }\n const knowledge = options.knowledgeBasePaths?.length\n ? await readDocuments(options.knowledgeBasePaths, options.signal)\n : null;\n const rubricCheckpointSha256 = workflowDigest(rubric);\n const metadata = {\n schemaVersion: 1 as const,\n classificationRuns,\n assessedAt: new Date().toISOString(),\n ...(defaultRubric\n ? {\n rubricSha256: defaultRubric.sha256,\n rubricRevision: defaultRubric.revision,\n }\n : {\n rubricSha256:\n rubric.length === 1\n ? hash(\"sha256\", rubric[0]!)\n : rubricCheckpointSha256,\n }),\n knowledgeBaseSha256: knowledge === null ? null : workflowDigest(knowledge),\n };\n const result: SeverityClassification = { ...metadata, assessments: [] };\n const binding = { ...metadata, rubricCheckpointSha256 };\n const cached = new Map((await checkpoint?.load(binding))?.map(findingEntry));\n for (const finding of findings) {\n options.signal?.throwIfAborted();\n const inputSha256 = workflowDigest(finding);\n const previous = cached.get(finding.findingId);\n if (previous?.inputSha256 === inputSha256) {\n validateSeverityClassification({ ...result, assessments: [previous] }, [\n finding,\n ]);\n result.assessments.push(previous);\n continue;\n }\n const prompt = [\n severityReviewInstructions,\n JSON.stringify({ rubric, knowledgeBase: knowledge, finding }),\n ].join(\"\\n\\n\");\n const decision = await reviewSeverity(async () => {\n options.signal?.throwIfAborted();\n const response = await runReadOnlyCodex(\n prompt,\n z.toJSONSchema(decisionSchema),\n options,\n {\n surface,\n command: \"classify-severity\",\n threadSource: CODEX_SECURITY_THREAD_SOURCES.severityClassification,\n },\n );\n options.signal?.throwIfAborted();\n try {\n return parseSeverityDecision(JSON.parse(response), finding.findingId);\n } catch (error) {\n throw new CodexSecurityError(\n \"Severity classification returned an invalid assessment.\",\n { cause: error },\n );\n }\n }, classificationRuns);\n options.signal?.throwIfAborted();\n const assessment: SeverityAssessment = {\n ...decision,\n occurrenceId: finding.occurrenceId ?? null,\n inputSha256,\n source: \"rubric\",\n };\n await checkpoint?.save(finding, assessment, binding);\n result.assessments.push(assessment);\n }\n options.signal?.throwIfAborted();\n return result;\n}\n\nasync function readDocuments(\n paths: readonly string[],\n signal?: AbortSignal,\n): Promise<string[]> {\n const contents = await readKnowledgeBaseDocuments(paths, signal);\n if (contents.every((text) => !text.trim())) {\n throw new CodexSecurityError(\"Classification documents must not be empty.\");\n }\n return contents;\n}\n\n/** @internal Check parsed assessments against the actual finding evidence. */\nexport function validateSeverityClassification(\n result: SeverityClassification,\n findings: readonly SeverityClassificationFinding[],\n): SeverityClassification {\n const byId = new Map(findings.map(findingEntry));\n for (const assessment of result.assessments) {\n const finding = byId.get(assessment.findingId);\n if (\n !finding ||\n assessment.occurrenceId !== (finding.occurrenceId ?? null) ||\n assessment.inputSha256 !== workflowDigest(finding) ||\n (assessment.source === \"rubric\") !== (result.rubricSha256 !== null) ||\n (assessment.decision === \"assessed\"\n ? assessment.level === null\n : assessment.level !== null) ||\n (assessment.source === \"rubric\" &&\n (assessment.decision === \"assessed\"\n ? assessment.rubricLabel === null\n : assessment.rubricLabel !== null)) ||\n (assessment.source === \"existing-severity\" &&\n (assessment.decision !== \"assessed\" ||\n assessment.level !== finding.severity?.level))\n ) {\n throw new CodexSecurityError(\n \"Severity assessment does not match the supplied findings. Classify the findings again.\",\n );\n }\n byId.delete(assessment.findingId);\n }\n return result;\n}\n"]}
|
|
1
|
+
{"version":3,"file":"classify-severity.js","sourceRoot":"","sources":["../src/classify-severity.ts"],"names":[],"mappings":"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","sourcesContent":["import { hash } from \"node:crypto\";\nimport {\n getDefaultSeverityRubric,\n type SeverityRubricSnapshot,\n} from \"./severity-rubric.js\";\nimport { findingEntry } from \"./value.js\";\nimport { z } from \"zod\";\nimport { CodexSecurityError } from \"./errors.js\";\nimport { workflowDigest } from \"./finding-workflow.js\";\nimport { readKnowledgeBaseSnapshot } from \"./knowledge-base.js\";\nimport type { DocumentRoots } from \"./prompt-files.js\";\nimport type { Finding } from \"./models.js\";\nimport {\n runReadOnlyCodex,\n type ReadOnlyCodexOptions,\n} from \"./scan-comparison.js\";\nimport {\n severityDecisionSchema as decisionSchema,\n severityReviewInstructions,\n parseSeverityDecision,\n reviewSeverity,\n classificationRunsSchema,\n reviewRunsOption,\n} from \"./severity-review.js\";\nimport { CODEX_SECURITY_THREAD_SOURCES } from \"./thread-source.js\";\n\n/** Full reports and explicitly supplied context from any finding source. */\nexport type SeverityClassificationFinding = Pick<\n Finding,\n \"findingId\" | \"title\" | \"summary\"\n> &\n Partial<Pick<Finding, \"occurrenceId\" | \"severity\">> &\n Record<string, unknown>;\n\nexport interface ClassifySeverityOptions extends Pick<\n ReadOnlyCodexOptions,\n | \"config\"\n | \"environment\"\n | \"model\"\n | \"reasoningEffort\"\n | \"signal\"\n | \"workingDirectory\"\n> {\n /** Overrides both the bundled default and the optional remote default. */\n rubricPath?: string;\n /** Independent reviews per finding: integer 1–10, default 3. */\n classificationRuns?: number;\n /** Supporting evidence, separate from classification policy. */\n knowledgeBasePaths?: readonly string[];\n /** @internal Test client for the shared read-only runtime. */\n codex?: ReadOnlyCodexOptions[\"codex\"];\n}\n\nexport interface SeverityAssessment extends z.infer<typeof decisionSchema> {\n occurrenceId: string | null;\n inputSha256: string;\n source: \"existing-severity\" | \"rubric\";\n}\n\nexport interface SeverityClassification {\n schemaVersion: 1;\n assessedAt: string;\n /** Absent on legacy results whose review count was not recorded. */\n classificationRuns?: number;\n /** SHA-256 of the exact policy text, or the ordered document digest for collections and legacy results. */\n rubricSha256: string | null;\n /** Revision of the bundled or remote rubric. Unversioned file inputs and legacy results omit it. */\n rubricRevision?: number;\n knowledgeBaseSha256: string | null;\n assessments: SeverityAssessment[];\n}\n\n/** @internal Document collections retain their original checkpoint key. */\nexport type SeverityClassificationBinding = Omit<\n SeverityClassification,\n \"assessments\"\n> & {\n rubricCheckpointSha256: string | null;\n};\n\n/** @internal Per-finding persistence used by saved-scan classification. */\nexport interface SeverityClassificationCheckpoint {\n load(binding: SeverityClassificationBinding): Promise<SeverityAssessment[]>;\n save(\n finding: SeverityClassificationFinding,\n assessment: SeverityAssessment,\n binding: SeverityClassificationBinding,\n ): Promise<void>;\n}\n\nconst textSchema = z\n .string()\n .min(1)\n .refine((value) => value.trim().length > 0);\nconst digestSchema = z.string().regex(/^[a-f0-9]{64}$/u);\n/** @internal */\nexport const severityClassificationSchema = z.strictObject({\n schemaVersion: z.literal(1),\n assessedAt: z.string().datetime(),\n classificationRuns: classificationRunsSchema.optional(),\n rubricSha256: digestSchema.nullable(),\n rubricRevision: z.number().int().positive().optional(),\n knowledgeBaseSha256: digestSchema.nullable(),\n assessments: z.array(\n decisionSchema.extend({\n occurrenceId: textSchema.nullable(),\n inputSha256: digestSchema,\n source: z.enum([\"existing-severity\", \"rubric\"]),\n }),\n ),\n}) satisfies z.ZodType<SeverityClassification>;\n\n/** Classify each supplied report independently, without scanning or writing findings. */\nexport async function classifySeverity(\n findings: readonly SeverityClassificationFinding[],\n options: ClassifySeverityOptions = {},\n): Promise<SeverityClassification> {\n return classifySeverityInternal(findings, options);\n}\n\n/** @internal */\nexport async function classifySeverityInternal(\n findings: readonly SeverityClassificationFinding[],\n options: ClassifySeverityOptions = {},\n surface: \"sdk\" | \"cli\" = \"sdk\",\n checkpoint?: SeverityClassificationCheckpoint,\n roots?: DocumentRoots,\n): Promise<SeverityClassification> {\n options.signal?.throwIfAborted();\n const classificationRuns = reviewRunsOption.parse(options.classificationRuns);\n const ids = new Set<string>();\n for (const finding of findings) {\n if (!finding.findingId?.trim() || ids.has(finding.findingId)) {\n throw new CodexSecurityError(\n \"Severity classification requires unique finding IDs.\",\n );\n }\n ids.add(finding.findingId);\n }\n let rubric: string[];\n let defaultRubric: SeverityRubricSnapshot | undefined;\n if (options.rubricPath === undefined) {\n defaultRubric = await getDefaultSeverityRubric(options);\n rubric = [defaultRubric.markdown];\n } else {\n rubric = await readDocuments([options.rubricPath], options.signal, roots);\n }\n const knowledge = options.knowledgeBasePaths?.length\n ? await readDocuments(options.knowledgeBasePaths, options.signal, roots)\n : null;\n const rubricCheckpointSha256 = workflowDigest(rubric);\n const metadata = {\n schemaVersion: 1 as const,\n classificationRuns,\n assessedAt: new Date().toISOString(),\n ...(defaultRubric\n ? {\n rubricSha256: defaultRubric.sha256,\n rubricRevision: defaultRubric.revision,\n }\n : {\n rubricSha256:\n rubric.length === 1\n ? hash(\"sha256\", rubric[0]!)\n : rubricCheckpointSha256,\n }),\n knowledgeBaseSha256: knowledge === null ? null : workflowDigest(knowledge),\n };\n const result: SeverityClassification = { ...metadata, assessments: [] };\n const binding = { ...metadata, rubricCheckpointSha256 };\n const cached = new Map((await checkpoint?.load(binding))?.map(findingEntry));\n for (const finding of findings) {\n options.signal?.throwIfAborted();\n const inputSha256 = workflowDigest(finding);\n const previous = cached.get(finding.findingId);\n if (previous?.inputSha256 === inputSha256) {\n validateSeverityClassification({ ...result, assessments: [previous] }, [\n finding,\n ]);\n result.assessments.push(previous);\n continue;\n }\n const prompt = [\n severityReviewInstructions,\n JSON.stringify({ rubric, knowledgeBase: knowledge, finding }),\n ].join(\"\\n\\n\");\n const decision = await reviewSeverity(async () => {\n options.signal?.throwIfAborted();\n const response = await runReadOnlyCodex(\n prompt,\n z.toJSONSchema(decisionSchema),\n options,\n {\n surface,\n command: \"classify-severity\",\n threadSource: CODEX_SECURITY_THREAD_SOURCES.severityClassification,\n },\n );\n options.signal?.throwIfAborted();\n try {\n return parseSeverityDecision(JSON.parse(response), finding.findingId);\n } catch (error) {\n throw new CodexSecurityError(\n \"Severity classification returned an invalid assessment.\",\n { cause: error },\n );\n }\n }, classificationRuns);\n options.signal?.throwIfAborted();\n const assessment: SeverityAssessment = {\n ...decision,\n occurrenceId: finding.occurrenceId ?? null,\n inputSha256,\n source: \"rubric\",\n };\n await checkpoint?.save(finding, assessment, binding);\n result.assessments.push(assessment);\n }\n options.signal?.throwIfAborted();\n return result;\n}\n\nasync function readDocuments(\n paths: readonly string[],\n signal?: AbortSignal,\n roots?: DocumentRoots,\n): Promise<string[]> {\n const { documents } = await readKnowledgeBaseSnapshot(paths, signal, roots);\n const contents = Object.keys(documents)\n .sort()\n .map((name) => documents[name]!);\n if (contents.every((text) => !text.trim())) {\n throw new CodexSecurityError(\"Classification documents must not be empty.\");\n }\n return contents;\n}\n\n/** @internal Check parsed assessments against the actual finding evidence. */\nexport function validateSeverityClassification(\n result: SeverityClassification,\n findings: readonly SeverityClassificationFinding[],\n): SeverityClassification {\n const byId = new Map(findings.map(findingEntry));\n for (const assessment of result.assessments) {\n const finding = byId.get(assessment.findingId);\n if (\n !finding ||\n assessment.occurrenceId !== (finding.occurrenceId ?? null) ||\n assessment.inputSha256 !== workflowDigest(finding) ||\n (assessment.source === \"rubric\") !== (result.rubricSha256 !== null) ||\n (assessment.decision === \"assessed\"\n ? assessment.level === null\n : assessment.level !== null) ||\n (assessment.source === \"rubric\" &&\n (assessment.decision === \"assessed\"\n ? assessment.rubricLabel === null\n : assessment.rubricLabel !== null)) ||\n (assessment.source === \"existing-severity\" &&\n (assessment.decision !== \"assessed\" ||\n assessment.level !== finding.severity?.level))\n ) {\n throw new CodexSecurityError(\n \"Severity assessment does not match the supplied findings. Classify the findings again.\",\n );\n }\n byId.delete(assessment.findingId);\n }\n return result;\n}\n"]}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cli-argument.d.ts","sourceRoot":"","sources":["../src/cli-argument.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASlD;AAED,wBAAgB,aAAa,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAI5D"}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
/** Quote a literal argument for the user's shell (PowerShell on Windows). */
|
|
2
|
+
export function quoteCliPath(value) {
|
|
3
|
+
if (/^[A-Za-z0-9_./:-]+$/u.test(value))
|
|
4
|
+
return value;
|
|
5
|
+
if (process.platform === "win32" && /^[A-Za-z0-9_./:\\-]+$/u.test(value))
|
|
6
|
+
return value;
|
|
7
|
+
const escaped = process.platform === "win32"
|
|
8
|
+
? value.replace(/['\u2018\u2019\u201a\u201b]/gu, (quote) => quote + quote)
|
|
9
|
+
: value.replaceAll("'", `'"'"'`);
|
|
10
|
+
return `'${escaped}'`;
|
|
11
|
+
}
|
|
12
|
+
export function cliShellLabel(quotedArgument) {
|
|
13
|
+
return process.platform === "win32" && quotedArgument.startsWith("'")
|
|
14
|
+
? " (PowerShell)"
|
|
15
|
+
: "";
|
|
16
|
+
}
|
|
17
|
+
//# sourceMappingURL=cli-argument.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cli-argument.js","sourceRoot":"","sources":["../src/cli-argument.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,IAAI,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACrD,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC;QACtE,OAAO,KAAK,CAAC;IACf,MAAM,OAAO,GACX,OAAO,CAAC,QAAQ,KAAK,OAAO;QAC1B,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,+BAA+B,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC;QAC1E,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,IAAI,OAAO,GAAG,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,cAAsB;IAClD,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,cAAc,CAAC,UAAU,CAAC,GAAG,CAAC;QACnE,CAAC,CAAC,eAAe;QACjB,CAAC,CAAC,EAAE,CAAC;AACT,CAAC","sourcesContent":["/** Quote a literal argument for the user's shell (PowerShell on Windows). */\nexport function quoteCliPath(value: string): string {\n if (/^[A-Za-z0-9_./:-]+$/u.test(value)) return value;\n if (process.platform === \"win32\" && /^[A-Za-z0-9_./:\\\\-]+$/u.test(value))\n return value;\n const escaped =\n process.platform === \"win32\"\n ? value.replace(/['\\u2018\\u2019\\u201a\\u201b]/gu, (quote) => quote + quote)\n : value.replaceAll(\"'\", `'\"'\"'`);\n return `'${escaped}'`;\n}\n\nexport function cliShellLabel(quotedArgument: string): string {\n return process.platform === \"win32\" && quotedArgument.startsWith(\"'\")\n ? \" (PowerShell)\"\n : \"\";\n}\n"]}
|
package/dist/cli-help.d.ts
CHANGED
|
@@ -1,3 +1,3 @@
|
|
|
1
1
|
/** Present Incur's generated help without changing its routing or command output. */
|
|
2
|
-
export declare function formatCliHelp(text: string, columns?: number): string;
|
|
2
|
+
export declare function formatCliHelp(text: string, columns?: number): string | undefined;
|
|
3
3
|
//# sourceMappingURL=cli-help.d.ts.map
|
package/dist/cli-help.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cli-help.d.ts","sourceRoot":"","sources":["../src/cli-help.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"cli-help.d.ts","sourceRoot":"","sources":["../src/cli-help.ts"],"names":[],"mappings":"AAsPA,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,SAAK,GAAG,MAAM,GAAG,SAAS,CAgL5E"}
|
package/dist/cli-help.js
CHANGED
|
@@ -1,21 +1,16 @@
|
|
|
1
1
|
import { DEEP_SCAN_SETTINGS, DeepScanSettingsSchema } from "./scan-settings.js";
|
|
2
2
|
const COMMAND_GROUPS = [
|
|
3
|
-
["Scan and
|
|
3
|
+
["Scan and remediate", ["scan", "policy", "validate", "patch", "verify-fix"]],
|
|
4
4
|
[
|
|
5
|
-
"Review
|
|
6
|
-
[
|
|
7
|
-
"scans",
|
|
8
|
-
"findings",
|
|
9
|
-
"classify-severity",
|
|
10
|
-
"dedupe",
|
|
11
|
-
"suggest-owners",
|
|
12
|
-
"export",
|
|
13
|
-
"import",
|
|
14
|
-
"publish",
|
|
15
|
-
],
|
|
5
|
+
"Review results",
|
|
6
|
+
["scans", "findings", "classify-severity", "dedupe", "suggest-owners"],
|
|
16
7
|
],
|
|
8
|
+
["Import and share", ["import", "publish", "export"]],
|
|
17
9
|
["Automate", ["bulk-scan", "scan-components", "install-hook"]],
|
|
18
|
-
[
|
|
10
|
+
[
|
|
11
|
+
"Configure and troubleshoot",
|
|
12
|
+
["login", "logout", "init", "info", "feedback", "update"],
|
|
13
|
+
],
|
|
19
14
|
];
|
|
20
15
|
const SCAN_GROUPS = [
|
|
21
16
|
["Scope", ["path", "diff", "head", "working-tree", "base"]],
|
|
@@ -42,7 +37,7 @@ const SCAN_GROUPS = [
|
|
|
42
37
|
["Patch after scanning", ["patch", "patch-severity", "create-pr"]],
|
|
43
38
|
];
|
|
44
39
|
const PUBLISH_GROUPS = [
|
|
45
|
-
["Input", ["scan", "scan-dir", "
|
|
40
|
+
["Input", ["scan", "scan-dir", "finding-id", "workflow-id"]],
|
|
46
41
|
["Destination", ["to", "findings-url"]],
|
|
47
42
|
[
|
|
48
43
|
"Linear",
|
|
@@ -78,6 +73,7 @@ const VALUE_LABELS = {
|
|
|
78
73
|
python: "path",
|
|
79
74
|
codex: "key=value",
|
|
80
75
|
"max-cost": "usd",
|
|
76
|
+
"max-total-cost": "usd",
|
|
81
77
|
"max-time": "minutes",
|
|
82
78
|
"max-time-hours": "hours",
|
|
83
79
|
"fail-on-severity": "level",
|
|
@@ -96,9 +92,10 @@ const VALUE_LABELS = {
|
|
|
96
92
|
"token-offset": "count",
|
|
97
93
|
to: "destination",
|
|
98
94
|
};
|
|
95
|
+
const OUTPUT_FLAGS = ["format", "json", "filter-output", "full-output"];
|
|
99
96
|
const OUTPUT_GROUPS = [
|
|
100
|
-
["Help and
|
|
101
|
-
["Output",
|
|
97
|
+
["Help and version", ["help", "version"]],
|
|
98
|
+
["Output", OUTPUT_FLAGS],
|
|
102
99
|
];
|
|
103
100
|
function rowName(row) {
|
|
104
101
|
return row.label.match(/--([\w-]+)/u)?.[1] ?? row.label;
|
|
@@ -166,6 +163,10 @@ function optionRow(row, command) {
|
|
|
166
163
|
}
|
|
167
164
|
return `<${VALUE_LABELS[name] ?? (type === "number" ? "count" : name)}>`;
|
|
168
165
|
});
|
|
166
|
+
if (name === "token-limit")
|
|
167
|
+
description = "Maximum tokens in the text view (nonnegative integer).";
|
|
168
|
+
if (name === "token-offset")
|
|
169
|
+
description = "Start the text view at this token (nonnegative integer).";
|
|
169
170
|
label = label.replace(/^--([\w-]+), (-\w)/u, "$2, --$1");
|
|
170
171
|
if (command === "scan" && !/default:/iu.test(description)) {
|
|
171
172
|
const setting = DEEP_SCAN_SETTINGS.find(([, , , flag]) => flag === `--${name}`);
|
|
@@ -181,16 +182,19 @@ function globalRows(rows, command) {
|
|
|
181
182
|
const scan = command === "scan" || command === "scan import";
|
|
182
183
|
const plainOutput = ["validate", "login", "logout", "export"].includes(command);
|
|
183
184
|
const visible = rows.filter(({ label }) => {
|
|
185
|
+
if (label === "--update")
|
|
186
|
+
return false;
|
|
184
187
|
if (scan && label.startsWith("--filter-output"))
|
|
185
188
|
return false;
|
|
186
189
|
return !(plainOutput &&
|
|
187
190
|
/^(--format |--filter-output |--full-output$|--token-)/u.test(label));
|
|
188
191
|
});
|
|
189
192
|
const formats = visible.find((row) => rowName(row) === "format");
|
|
190
|
-
if (formats &&
|
|
193
|
+
if (formats &&
|
|
194
|
+
(scan || command === "scans rerun" || command === "scans resume")) {
|
|
191
195
|
formats.label = formats.label.replace("|md", "");
|
|
192
196
|
}
|
|
193
|
-
if (formats
|
|
197
|
+
if (formats) {
|
|
194
198
|
visible.push({
|
|
195
199
|
label: "--json",
|
|
196
200
|
description: "Shorthand for --format json.",
|
|
@@ -202,7 +206,7 @@ function globalRows(rows, command) {
|
|
|
202
206
|
export function formatCliHelp(text, columns = 80) {
|
|
203
207
|
const header = text.match(/^(codex-security(?:@[^\s]+)?((?: [a-z][a-z-]*)*))(?: — ([^\n]*))?\n\nUsage: /u);
|
|
204
208
|
if (!header)
|
|
205
|
-
return
|
|
209
|
+
return undefined;
|
|
206
210
|
const command = header[2].trim();
|
|
207
211
|
const sections = [];
|
|
208
212
|
// Presentation width only; long paths and copyable commands remain intact.
|
|
@@ -224,22 +228,41 @@ export function formatCliHelp(text, columns = 80) {
|
|
|
224
228
|
}
|
|
225
229
|
sections.push(usage
|
|
226
230
|
.split("\n")
|
|
227
|
-
.map((line) => wrap(line, width, "", " "))
|
|
231
|
+
.map((line) => wrap(line.trimStart(), width, line.startsWith(" ") ? " " : "", " "))
|
|
228
232
|
.join("\n"));
|
|
229
233
|
if (command === "") {
|
|
230
234
|
sections.push([
|
|
231
235
|
"Get started:",
|
|
236
|
+
" codex-security scan . --dry-run",
|
|
232
237
|
" codex-security login",
|
|
233
|
-
"",
|
|
234
|
-
wrap("In your repository, draft SECURITY.md (optional):", width, " ", " "),
|
|
235
|
-
" codex-security policy .",
|
|
236
|
-
wrap("Review the diff and notes. Edit the draft, then copy only SECURITY.md to the Policy target shown.", width, " ", " "),
|
|
237
|
-
wrap("Skip this step to keep your existing policy or scan without one.", width, " ", " "),
|
|
238
|
-
"",
|
|
239
238
|
" codex-security scan .",
|
|
240
|
-
" codex-security
|
|
239
|
+
" codex-security scans show",
|
|
241
240
|
].join("\n"));
|
|
242
241
|
}
|
|
242
|
+
else if (command === "import") {
|
|
243
|
+
sections.push(renderRows("Choose your input", [
|
|
244
|
+
{
|
|
245
|
+
label: "Live provider",
|
|
246
|
+
description: "Choose a collector below.",
|
|
247
|
+
},
|
|
248
|
+
{
|
|
249
|
+
label: "CLI, API, or MCP source",
|
|
250
|
+
description: "Ask Codex to import it using the publish-findings skill.",
|
|
251
|
+
},
|
|
252
|
+
{
|
|
253
|
+
label: "Workbench findings",
|
|
254
|
+
description: "Ask Codex to publish a stored import or selected finding versions.",
|
|
255
|
+
},
|
|
256
|
+
{
|
|
257
|
+
label: "Saved vendor report",
|
|
258
|
+
description: "See codex-security publish findings --help for local storage and publication.",
|
|
259
|
+
},
|
|
260
|
+
{
|
|
261
|
+
label: "Codex Security CSV or JSON",
|
|
262
|
+
description: "See codex-security scan import --help to add the export to local scan history.",
|
|
263
|
+
},
|
|
264
|
+
], width));
|
|
265
|
+
}
|
|
243
266
|
else if (examples) {
|
|
244
267
|
sections.push(examples);
|
|
245
268
|
}
|
|
@@ -254,15 +277,31 @@ export function formatCliHelp(text, columns = 80) {
|
|
|
254
277
|
: [renderRows("Commands", rows, width)]));
|
|
255
278
|
}
|
|
256
279
|
else if (title === "Options:") {
|
|
257
|
-
const
|
|
280
|
+
const options = parseRows(lines)
|
|
281
|
+
.filter((row) => !(command === "publish scan" && rowName(row) === "csv") &&
|
|
282
|
+
!(command === "publish check" && rowName(row) === "to"))
|
|
283
|
+
.map((row) => optionRow(row, command));
|
|
284
|
+
const rows = options.filter((row) => !row.description.startsWith("[deprecated]"));
|
|
258
285
|
sections.push(...(command === "scan"
|
|
259
286
|
? groupedRows(rows, SCAN_GROUPS, "Advanced", width)
|
|
260
287
|
: command === "publish scan"
|
|
261
288
|
? groupedRows(rows, PUBLISH_GROUPS, "Options", width)
|
|
262
289
|
: [renderRows("Options", rows, width)]));
|
|
290
|
+
const deprecated = options.filter((row) => row.description.startsWith("[deprecated]"));
|
|
291
|
+
if (deprecated.length)
|
|
292
|
+
sections.push(renderRows("Deprecated options", deprecated, width));
|
|
263
293
|
}
|
|
264
294
|
else if (title === "Global Options:") {
|
|
265
|
-
|
|
295
|
+
const rows = globalRows(parseRows(lines), command);
|
|
296
|
+
if (command === "") {
|
|
297
|
+
sections.push(...groupedRows(rows, OUTPUT_GROUPS, "Agent options", width));
|
|
298
|
+
}
|
|
299
|
+
else {
|
|
300
|
+
const outputRows = rows.filter((row) => OUTPUT_FLAGS.includes(rowName(row)));
|
|
301
|
+
if (outputRows.length)
|
|
302
|
+
sections.push(renderRows("Output", outputRows, width));
|
|
303
|
+
sections.push(wrap("See codex-security --help for shared help and agent options.", width));
|
|
304
|
+
}
|
|
266
305
|
}
|
|
267
306
|
else if (["Arguments:", "Integrations:", "Environment Variables:"].includes(title)) {
|
|
268
307
|
const rows = parseRows(lines).map((row) => ({
|
|
@@ -280,6 +319,9 @@ export function formatCliHelp(text, columns = 80) {
|
|
|
280
319
|
.join("\n"));
|
|
281
320
|
}
|
|
282
321
|
}
|
|
322
|
+
if (command === "completions") {
|
|
323
|
+
sections.push(wrap("Shell setup: https://github.com/openai/codex-security/blob/main/sdk/typescript/docs/cli.md#shell-completions", width));
|
|
324
|
+
}
|
|
283
325
|
if (command === "") {
|
|
284
326
|
sections.push(wrap("Use codex-security <command> --help for options and examples.", width));
|
|
285
327
|
sections.push("Docs: https://learn.chatgpt.com/docs/security/cli");
|
package/dist/cli-help.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cli-help.js","sourceRoot":"","sources":["../src/cli-help.ts"],"names":[],"mappings":"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","sourcesContent":["import { DEEP_SCAN_SETTINGS, DeepScanSettingsSchema } from \"./scan-settings.js\";\n\ntype Row = { label: string; description: string };\ntype Group = readonly [title: string, names: readonly string[]];\n\nconst COMMAND_GROUPS: readonly Group[] = [\n [\"Scan and fix\", [\"scan\", \"policy\", \"validate\", \"patch\", \"verify-fix\"]],\n [\n \"Review and share\",\n [\n \"scans\",\n \"findings\",\n \"classify-severity\",\n \"dedupe\",\n \"suggest-owners\",\n \"export\",\n \"import\",\n \"publish\",\n ],\n ],\n [\"Automate\", [\"bulk-scan\", \"scan-components\", \"install-hook\"]],\n [\"Setup and support\", [\"login\", \"logout\", \"init\", \"info\", \"feedback\"]],\n];\n\nconst SCAN_GROUPS: readonly Group[] = [\n [\"Scope\", [\"path\", \"diff\", \"head\", \"working-tree\", \"base\"]],\n [\"Configuration\", [\"config\", \"mode\", \"knowledge-base\", \"dry-run\"]],\n [\"Model and authentication\", [\"auth\", \"model\", \"effort\", \"provider\"]],\n [\n \"Deep Scan\",\n DEEP_SCAN_SETTINGS.flatMap(([, , , flag]) =>\n flag === null ? [] : [flag.slice(2)],\n ),\n ],\n [\n \"Results, progress, and limits\",\n [\n \"output-dir\",\n \"archive-existing\",\n \"owner-suggestions\",\n \"max-cost\",\n \"max-time\",\n \"show-cost\",\n \"fail-on-severity\",\n \"headless\",\n \"verbose\",\n ],\n ],\n [\"Patch after scanning\", [\"patch\", \"patch-severity\", \"create-pr\"]],\n];\n\nconst PUBLISH_GROUPS: readonly Group[] = [\n [\"Input\", [\"scan\", \"scan-dir\", \"csv\", \"finding-id\", \"workflow-id\"]],\n [\"Destination\", [\"to\", \"findings-url\"]],\n [\n \"Linear\",\n [\n \"linear-team\",\n \"linear-project\",\n \"linear-assignee\",\n \"linear-api-key\",\n \"project\",\n ],\n ],\n [\"Publishing\", [\"dry-run\", \"skip-existing\"]],\n];\n\nconst VALUE_LABELS: Record<string, string> = {\n context: \"text\",\n \"context-file\": \"file\",\n \"output-schema\": \"file\",\n config: \"file\",\n path: \"path\",\n \"knowledge-base\": \"path\",\n \"scan-prompt-file\": \"file\",\n \"validation-prompt-file\": \"file\",\n \"post-scan-prompt-file\": \"file\",\n diff: \"ref\",\n head: \"ref\",\n base: \"ref\",\n model: \"model\",\n \"output-dir\": \"path\",\n \"scan-dir\": \"path\",\n \"plugin-path\": \"path\",\n \"source-root\": \"path\",\n \"avit-template\": \"file\",\n python: \"path\",\n codex: \"key=value\",\n \"max-cost\": \"usd\",\n \"max-time\": \"minutes\",\n \"max-time-hours\": \"hours\",\n \"fail-on-severity\": \"level\",\n \"patch-severity\": \"level\",\n severity: \"level\",\n scan: \"scan-id\",\n \"finding-id\": \"id\",\n \"findings-url\": \"url\",\n output: \"file\",\n csv: \"file\",\n json: \"file\",\n rubric: \"file\",\n \"export-format\": \"format\",\n \"filter-output\": \"keys\",\n \"token-limit\": \"count\",\n \"token-offset\": \"count\",\n to: \"destination\",\n};\n\nconst OUTPUT_GROUPS: readonly Group[] = [\n [\"Help and updates\", [\"help\", \"version\", \"update\"]],\n [\"Output\", [\"format\", \"json\", \"filter-output\", \"full-output\"]],\n];\n\nfunction rowName(row: Row): string {\n return row.label.match(/--([\\w-]+)/u)?.[1] ?? row.label;\n}\n\nfunction parseRows(lines: string[]): Row[] {\n return lines.map((line) => {\n const match = line.trim().match(/^(.*?)\\s{2,}(.*)$/u);\n return { label: match?.[1] ?? line.trim(), description: match?.[2] ?? \"\" };\n });\n}\n\nfunction wrap(text: string, width: number, prefix = \"\", next = prefix): string {\n const lines: string[] = [];\n let line = prefix;\n let indent = prefix.length;\n for (const word of text.split(/\\s+/u)) {\n if (line.length > indent && line.length + 1 + word.length > width) {\n lines.push(line);\n line = next;\n indent = next.length;\n }\n line += `${line.length > indent ? \" \" : \"\"}${word}`;\n }\n lines.push(line);\n return lines.join(\"\\n\");\n}\n\nfunction renderRows(title: string, rows: Row[], width: number): string {\n // Keep long option names from moving every description across the terminal.\n const column = Math.min(\n 30,\n Math.floor(width / 2),\n Math.max(...rows.map((row) => row.label.length)) + 4,\n );\n return [\n `${title}:`,\n ...rows.map(({ label, description }) => {\n if (!description) return ` ${label}`;\n if (label.length + 4 > column) {\n return ` ${label}\\n${wrap(description, width, \" \")}`;\n }\n return wrap(\n description,\n width,\n ` ${label}${\" \".repeat(column - label.length - 2)}`,\n \" \".repeat(column),\n );\n }),\n ].join(\"\\n\");\n}\n\nfunction groupedRows(\n rows: Row[],\n groups: readonly Group[],\n remainingTitle: string,\n width: number,\n): string[] {\n const remaining = new Map(rows.map((row) => [rowName(row), row]));\n const sections: string[] = [];\n for (const [title, names] of groups) {\n const selected = names.flatMap((name) => {\n const row = remaining.get(name);\n remaining.delete(name);\n return row === undefined ? [] : [row];\n });\n if (selected.length) sections.push(renderRows(title, selected, width));\n }\n if (remaining.size) {\n sections.push(renderRows(remainingTitle, [...remaining.values()], width));\n }\n return sections;\n}\n\nfunction optionRow(row: Row, command: string): Row {\n const name = rowName(row);\n let { label, description } = row;\n label = label.replace(/<([^>]+)>/u, (_, type: string) => {\n const choices = type.split(\"|\");\n if (choices.length > 1) {\n description += `${description.endsWith(\".\") ? \"\" : \".\"} Choices: ${choices.join(\", \")}.`;\n }\n return `<${VALUE_LABELS[name] ?? (type === \"number\" ? \"count\" : name)}>`;\n });\n label = label.replace(/^--([\\w-]+), (-\\w)/u, \"$2, --$1\");\n if (command === \"scan\" && !/default:/iu.test(description)) {\n const setting = DEEP_SCAN_SETTINGS.find(\n ([, , , flag]) => flag === `--${name}`,\n );\n if (setting) {\n const value =\n DeepScanSettingsSchema.shape[setting[0]].meta()?.[\"default\"];\n if (value !== undefined) description += ` (default: ${value})`;\n }\n }\n return { label, description };\n}\n\nfunction globalRows(rows: Row[], command: string): Row[] {\n const scan = command === \"scan\" || command === \"scan import\";\n const plainOutput = [\"validate\", \"login\", \"logout\", \"export\"].includes(\n command,\n );\n const visible = rows.filter(({ label }) => {\n if (scan && label.startsWith(\"--filter-output\")) return false;\n return !(\n plainOutput &&\n /^(--format |--filter-output |--full-output$|--token-)/u.test(label)\n );\n });\n const formats = visible.find((row) => rowName(row) === \"format\");\n if (formats && (scan || command === \"scans rerun\")) {\n formats.label = formats.label.replace(\"|md\", \"\");\n }\n if (formats && command !== \"scan import\") {\n visible.push({\n label: \"--json\",\n description: \"Shorthand for --format json.\",\n });\n }\n return visible.map((row) =>\n optionRow(\n row.label === \"--help\" ? { ...row, label: \"-h, --help\" } : row,\n command,\n ),\n );\n}\n\n/** Present Incur's generated help without changing its routing or command output. */\nexport function formatCliHelp(text: string, columns = 80): string {\n const header = text.match(\n /^(codex-security(?:@[^\\s]+)?((?: [a-z][a-z-]*)*))(?: — ([^\\n]*))?\\n\\nUsage: /u,\n );\n if (!header) return text;\n const command = header[2]!.trim();\n const sections: string[] = [];\n // Presentation width only; long paths and copyable commands remain intact.\n const width = columns > 0 ? columns : 80;\n const blocks = text.trimEnd().split(/\\n\\n/u);\n const examples = blocks.find((block) => block.startsWith(\"Examples:\\n\"));\n for (const [index, block] of blocks.entries()) {\n const [title = \"\", ...lines] = block.split(\"\\n\");\n if (index === 0) {\n sections.push(\n [header[1], header[3] && wrap(header[3], width)]\n .filter(Boolean)\n .join(\"\\n\"),\n );\n } else if (title.startsWith(\"Usage: \")) {\n let usage = block.replace(\n /([a-z])([A-Z])/gu,\n (_, lower: string, upper: string) => `${lower}-${upper.toLowerCase()}`,\n );\n if (command === \"scans\" || command === \"findings\") {\n usage = usage.replace(\"<command>\", \"[command]\");\n usage += \"\\nDefault command: list\";\n }\n sections.push(\n usage\n .split(\"\\n\")\n .map((line) => wrap(line, width, \"\", \" \"))\n .join(\"\\n\"),\n );\n if (command === \"\") {\n sections.push(\n [\n \"Get started:\",\n \" codex-security login\",\n \"\",\n wrap(\n \"In your repository, draft SECURITY.md (optional):\",\n width,\n \" \",\n \" \",\n ),\n \" codex-security policy .\",\n wrap(\n \"Review the diff and notes. Edit the draft, then copy only SECURITY.md to the Policy target shown.\",\n width,\n \" \",\n \" \",\n ),\n wrap(\n \"Skip this step to keep your existing policy or scan without one.\",\n width,\n \" \",\n \" \",\n ),\n \"\",\n \" codex-security scan .\",\n \" codex-security findings\",\n ].join(\"\\n\"),\n );\n } else if (examples) {\n sections.push(examples);\n }\n } else if (title === \"Examples:\") {\n continue;\n } else if (title === \"Commands:\") {\n const rows = parseRows(lines);\n sections.push(\n ...(command === \"\"\n ? groupedRows(rows, COMMAND_GROUPS, \"Other commands\", width)\n : [renderRows(\"Commands\", rows, width)]),\n );\n } else if (title === \"Options:\") {\n const rows = parseRows(lines).map((row) => optionRow(row, command));\n sections.push(\n ...(command === \"scan\"\n ? groupedRows(rows, SCAN_GROUPS, \"Advanced\", width)\n : command === \"publish scan\"\n ? groupedRows(rows, PUBLISH_GROUPS, \"Options\", width)\n : [renderRows(\"Options\", rows, width)]),\n );\n } else if (title === \"Global Options:\") {\n sections.push(\n ...groupedRows(\n globalRows(parseRows(lines), command),\n OUTPUT_GROUPS,\n \"Agent options\",\n width,\n ),\n );\n } else if (\n [\"Arguments:\", \"Integrations:\", \"Environment Variables:\"].includes(title)\n ) {\n const rows = parseRows(lines).map((row) => ({\n ...row,\n label:\n title === \"Arguments:\"\n ? row.label.replace(/([a-z])([A-Z])/gu, \"$1-$2\").toLowerCase()\n : row.label,\n }));\n sections.push(renderRows(title.slice(0, -1), rows, width));\n } else {\n sections.push(\n block\n .split(\"\\n\")\n .map((line) => (line.startsWith(\" \") ? line : wrap(line, width)))\n .join(\"\\n\"),\n );\n }\n }\n if (command === \"\") {\n sections.push(\n wrap(\n \"Use codex-security <command> --help for options and examples.\",\n width,\n ),\n );\n sections.push(\"Docs: https://learn.chatgpt.com/docs/security/cli\");\n }\n return `${sections.join(\"\\n\\n\")}\\n`;\n}\n"]}
|
|
1
|
+
{"version":3,"file":"cli-help.js","sourceRoot":"","sources":["../src/cli-help.ts"],"names":[],"mappings":"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","sourcesContent":["import { DEEP_SCAN_SETTINGS, DeepScanSettingsSchema } from \"./scan-settings.js\";\n\ntype Row = { label: string; description: string };\ntype Group = readonly [title: string, names: readonly string[]];\n\nconst COMMAND_GROUPS: readonly Group[] = [\n [\"Scan and remediate\", [\"scan\", \"policy\", \"validate\", \"patch\", \"verify-fix\"]],\n [\n \"Review results\",\n [\"scans\", \"findings\", \"classify-severity\", \"dedupe\", \"suggest-owners\"],\n ],\n [\"Import and share\", [\"import\", \"publish\", \"export\"]],\n [\"Automate\", [\"bulk-scan\", \"scan-components\", \"install-hook\"]],\n [\n \"Configure and troubleshoot\",\n [\"login\", \"logout\", \"init\", \"info\", \"feedback\", \"update\"],\n ],\n];\n\nconst SCAN_GROUPS: readonly Group[] = [\n [\"Scope\", [\"path\", \"diff\", \"head\", \"working-tree\", \"base\"]],\n [\"Configuration\", [\"config\", \"mode\", \"knowledge-base\", \"dry-run\"]],\n [\"Model and authentication\", [\"auth\", \"model\", \"effort\", \"provider\"]],\n [\n \"Deep Scan\",\n DEEP_SCAN_SETTINGS.flatMap(([, , , flag]) =>\n flag === null ? [] : [flag.slice(2)],\n ),\n ],\n [\n \"Results, progress, and limits\",\n [\n \"output-dir\",\n \"archive-existing\",\n \"owner-suggestions\",\n \"max-cost\",\n \"max-time\",\n \"show-cost\",\n \"fail-on-severity\",\n \"headless\",\n \"verbose\",\n ],\n ],\n [\"Patch after scanning\", [\"patch\", \"patch-severity\", \"create-pr\"]],\n];\n\nconst PUBLISH_GROUPS: readonly Group[] = [\n [\"Input\", [\"scan\", \"scan-dir\", \"finding-id\", \"workflow-id\"]],\n [\"Destination\", [\"to\", \"findings-url\"]],\n [\n \"Linear\",\n [\n \"linear-team\",\n \"linear-project\",\n \"linear-assignee\",\n \"linear-api-key\",\n \"project\",\n ],\n ],\n [\"Publishing\", [\"dry-run\", \"skip-existing\"]],\n];\n\nconst VALUE_LABELS: Record<string, string> = {\n context: \"text\",\n \"context-file\": \"file\",\n \"output-schema\": \"file\",\n config: \"file\",\n path: \"path\",\n \"knowledge-base\": \"path\",\n \"scan-prompt-file\": \"file\",\n \"validation-prompt-file\": \"file\",\n \"post-scan-prompt-file\": \"file\",\n diff: \"ref\",\n head: \"ref\",\n base: \"ref\",\n model: \"model\",\n \"output-dir\": \"path\",\n \"scan-dir\": \"path\",\n \"plugin-path\": \"path\",\n \"source-root\": \"path\",\n \"avit-template\": \"file\",\n python: \"path\",\n codex: \"key=value\",\n \"max-cost\": \"usd\",\n \"max-total-cost\": \"usd\",\n \"max-time\": \"minutes\",\n \"max-time-hours\": \"hours\",\n \"fail-on-severity\": \"level\",\n \"patch-severity\": \"level\",\n severity: \"level\",\n scan: \"scan-id\",\n \"finding-id\": \"id\",\n \"findings-url\": \"url\",\n output: \"file\",\n csv: \"file\",\n json: \"file\",\n rubric: \"file\",\n \"export-format\": \"format\",\n \"filter-output\": \"keys\",\n \"token-limit\": \"count\",\n \"token-offset\": \"count\",\n to: \"destination\",\n};\n\nconst OUTPUT_FLAGS = [\"format\", \"json\", \"filter-output\", \"full-output\"];\n\nconst OUTPUT_GROUPS: readonly Group[] = [\n [\"Help and version\", [\"help\", \"version\"]],\n [\"Output\", OUTPUT_FLAGS],\n];\n\nfunction rowName(row: Row): string {\n return row.label.match(/--([\\w-]+)/u)?.[1] ?? row.label;\n}\n\nfunction parseRows(lines: string[]): Row[] {\n return lines.map((line) => {\n const match = line.trim().match(/^(.*?)\\s{2,}(.*)$/u);\n return { label: match?.[1] ?? line.trim(), description: match?.[2] ?? \"\" };\n });\n}\n\nfunction wrap(text: string, width: number, prefix = \"\", next = prefix): string {\n const lines: string[] = [];\n let line = prefix;\n let indent = prefix.length;\n for (const word of text.split(/\\s+/u)) {\n if (line.length > indent && line.length + 1 + word.length > width) {\n lines.push(line);\n line = next;\n indent = next.length;\n }\n line += `${line.length > indent ? \" \" : \"\"}${word}`;\n }\n lines.push(line);\n return lines.join(\"\\n\");\n}\n\nfunction renderRows(title: string, rows: Row[], width: number): string {\n // Keep long option names from moving every description across the terminal.\n const column = Math.min(\n 30,\n Math.floor(width / 2),\n Math.max(...rows.map((row) => row.label.length)) + 4,\n );\n return [\n `${title}:`,\n ...rows.map(({ label, description }) => {\n if (!description) return ` ${label}`;\n if (label.length + 4 > column) {\n return ` ${label}\\n${wrap(description, width, \" \")}`;\n }\n return wrap(\n description,\n width,\n ` ${label}${\" \".repeat(column - label.length - 2)}`,\n \" \".repeat(column),\n );\n }),\n ].join(\"\\n\");\n}\n\nfunction groupedRows(\n rows: Row[],\n groups: readonly Group[],\n remainingTitle: string,\n width: number,\n): string[] {\n const remaining = new Map(rows.map((row) => [rowName(row), row]));\n const sections: string[] = [];\n for (const [title, names] of groups) {\n const selected = names.flatMap((name) => {\n const row = remaining.get(name);\n remaining.delete(name);\n return row === undefined ? [] : [row];\n });\n if (selected.length) sections.push(renderRows(title, selected, width));\n }\n if (remaining.size) {\n sections.push(renderRows(remainingTitle, [...remaining.values()], width));\n }\n return sections;\n}\n\nfunction optionRow(row: Row, command: string): Row {\n const name = rowName(row);\n let { label, description } = row;\n label = label.replace(/<([^>]+)>/u, (_, type: string) => {\n const choices = type.split(\"|\");\n if (choices.length > 1) {\n description += `${description.endsWith(\".\") ? \"\" : \".\"} Choices: ${choices.join(\", \")}.`;\n }\n return `<${VALUE_LABELS[name] ?? (type === \"number\" ? \"count\" : name)}>`;\n });\n if (name === \"token-limit\")\n description = \"Maximum tokens in the text view (nonnegative integer).\";\n if (name === \"token-offset\")\n description = \"Start the text view at this token (nonnegative integer).\";\n label = label.replace(/^--([\\w-]+), (-\\w)/u, \"$2, --$1\");\n if (command === \"scan\" && !/default:/iu.test(description)) {\n const setting = DEEP_SCAN_SETTINGS.find(\n ([, , , flag]) => flag === `--${name}`,\n );\n if (setting) {\n const value =\n DeepScanSettingsSchema.shape[setting[0]].meta()?.[\"default\"];\n if (value !== undefined) description += ` (default: ${value})`;\n }\n }\n return { label, description };\n}\n\nfunction globalRows(rows: Row[], command: string): Row[] {\n const scan = command === \"scan\" || command === \"scan import\";\n const plainOutput = [\"validate\", \"login\", \"logout\", \"export\"].includes(\n command,\n );\n const visible = rows.filter(({ label }) => {\n if (label === \"--update\") return false;\n if (scan && label.startsWith(\"--filter-output\")) return false;\n return !(\n plainOutput &&\n /^(--format |--filter-output |--full-output$|--token-)/u.test(label)\n );\n });\n const formats = visible.find((row) => rowName(row) === \"format\");\n if (\n formats &&\n (scan || command === \"scans rerun\" || command === \"scans resume\")\n ) {\n formats.label = formats.label.replace(\"|md\", \"\");\n }\n if (formats) {\n visible.push({\n label: \"--json\",\n description: \"Shorthand for --format json.\",\n });\n }\n return visible.map((row) =>\n optionRow(\n row.label === \"--help\" ? { ...row, label: \"-h, --help\" } : row,\n command,\n ),\n );\n}\n\n/** Present Incur's generated help without changing its routing or command output. */\nexport function formatCliHelp(text: string, columns = 80): string | undefined {\n const header = text.match(\n /^(codex-security(?:@[^\\s]+)?((?: [a-z][a-z-]*)*))(?: — ([^\\n]*))?\\n\\nUsage: /u,\n );\n if (!header) return undefined;\n const command = header[2]!.trim();\n const sections: string[] = [];\n // Presentation width only; long paths and copyable commands remain intact.\n const width = columns > 0 ? columns : 80;\n const blocks = text.trimEnd().split(/\\n\\n/u);\n const examples = blocks.find((block) => block.startsWith(\"Examples:\\n\"));\n for (const [index, block] of blocks.entries()) {\n const [title = \"\", ...lines] = block.split(\"\\n\");\n if (index === 0) {\n sections.push(\n [header[1], header[3] && wrap(header[3], width)]\n .filter(Boolean)\n .join(\"\\n\"),\n );\n } else if (title.startsWith(\"Usage: \")) {\n let usage = block.replace(\n /([a-z])([A-Z])/gu,\n (_, lower: string, upper: string) => `${lower}-${upper.toLowerCase()}`,\n );\n if (command === \"scans\" || command === \"findings\") {\n usage = usage.replace(\"<command>\", \"[command]\");\n usage += \"\\nDefault command: list\";\n }\n sections.push(\n usage\n .split(\"\\n\")\n .map((line) =>\n wrap(\n line.trimStart(),\n width,\n line.startsWith(\" \") ? \" \" : \"\",\n \" \",\n ),\n )\n .join(\"\\n\"),\n );\n if (command === \"\") {\n sections.push(\n [\n \"Get started:\",\n \" codex-security scan . --dry-run\",\n \" codex-security login\",\n \" codex-security scan .\",\n \" codex-security scans show\",\n ].join(\"\\n\"),\n );\n } else if (command === \"import\") {\n sections.push(\n renderRows(\n \"Choose your input\",\n [\n {\n label: \"Live provider\",\n description: \"Choose a collector below.\",\n },\n {\n label: \"CLI, API, or MCP source\",\n description:\n \"Ask Codex to import it using the publish-findings skill.\",\n },\n {\n label: \"Workbench findings\",\n description:\n \"Ask Codex to publish a stored import or selected finding versions.\",\n },\n {\n label: \"Saved vendor report\",\n description:\n \"See codex-security publish findings --help for local storage and publication.\",\n },\n {\n label: \"Codex Security CSV or JSON\",\n description:\n \"See codex-security scan import --help to add the export to local scan history.\",\n },\n ],\n width,\n ),\n );\n } else if (examples) {\n sections.push(examples);\n }\n } else if (title === \"Examples:\") {\n continue;\n } else if (title === \"Commands:\") {\n const rows = parseRows(lines);\n sections.push(\n ...(command === \"\"\n ? groupedRows(rows, COMMAND_GROUPS, \"Other commands\", width)\n : [renderRows(\"Commands\", rows, width)]),\n );\n } else if (title === \"Options:\") {\n const options = parseRows(lines)\n .filter(\n (row) =>\n !(command === \"publish scan\" && rowName(row) === \"csv\") &&\n !(command === \"publish check\" && rowName(row) === \"to\"),\n )\n .map((row) => optionRow(row, command));\n const rows = options.filter(\n (row) => !row.description.startsWith(\"[deprecated]\"),\n );\n sections.push(\n ...(command === \"scan\"\n ? groupedRows(rows, SCAN_GROUPS, \"Advanced\", width)\n : command === \"publish scan\"\n ? groupedRows(rows, PUBLISH_GROUPS, \"Options\", width)\n : [renderRows(\"Options\", rows, width)]),\n );\n const deprecated = options.filter((row) =>\n row.description.startsWith(\"[deprecated]\"),\n );\n if (deprecated.length)\n sections.push(renderRows(\"Deprecated options\", deprecated, width));\n } else if (title === \"Global Options:\") {\n const rows = globalRows(parseRows(lines), command);\n if (command === \"\") {\n sections.push(\n ...groupedRows(rows, OUTPUT_GROUPS, \"Agent options\", width),\n );\n } else {\n const outputRows = rows.filter((row) =>\n OUTPUT_FLAGS.includes(rowName(row)),\n );\n if (outputRows.length)\n sections.push(renderRows(\"Output\", outputRows, width));\n sections.push(\n wrap(\n \"See codex-security --help for shared help and agent options.\",\n width,\n ),\n );\n }\n } else if (\n [\"Arguments:\", \"Integrations:\", \"Environment Variables:\"].includes(title)\n ) {\n const rows = parseRows(lines).map((row) => ({\n ...row,\n label:\n title === \"Arguments:\"\n ? row.label.replace(/([a-z])([A-Z])/gu, \"$1-$2\").toLowerCase()\n : row.label,\n }));\n sections.push(renderRows(title.slice(0, -1), rows, width));\n } else {\n sections.push(\n block\n .split(\"\\n\")\n .map((line) => (line.startsWith(\" \") ? line : wrap(line, width)))\n .join(\"\\n\"),\n );\n }\n }\n if (command === \"completions\") {\n sections.push(\n wrap(\n \"Shell setup: https://github.com/openai/codex-security/blob/main/sdk/typescript/docs/cli.md#shell-completions\",\n width,\n ),\n );\n }\n if (command === \"\") {\n sections.push(\n wrap(\n \"Use codex-security <command> --help for options and examples.\",\n width,\n ),\n );\n sections.push(\"Docs: https://learn.chatgpt.com/docs/security/cli\");\n }\n return `${sections.join(\"\\n\\n\")}\\n`;\n}\n"]}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cli-hook.d.ts","sourceRoot":"","sources":["../src/cli-hook.ts"],"names":[],"mappings":"AAYA,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAG5B,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,eAAe,GACzB,OAAO,CAAC,IAAI,CAAC,CAiFf"}
|
package/dist/cli-hook.js
ADDED
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
import { randomUUID } from "node:crypto";
|
|
2
|
+
import { constants } from "node:fs";
|
|
3
|
+
import { access, lstat, mkdir, open, rename, rm, writeFile, } from "node:fs/promises";
|
|
4
|
+
import { dirname } from "node:path";
|
|
5
|
+
import { REPORTABLE_SEVERITIES, } from "./scan-settings.js";
|
|
6
|
+
import { UNSUPPORTED_GIT_ENVIRONMENT } from "./targets.js";
|
|
7
|
+
export async function installManagedHook(hook, command, threshold) {
|
|
8
|
+
const header = "#!/bin/sh\nset -eu\n";
|
|
9
|
+
const unset = `unset ${[...UNSUPPORTED_GIT_ENVIRONMENT].join(" ")}\n`;
|
|
10
|
+
const scan = (launcher, level) => `exec ${launcher} scan . --working-tree --fail-on-severity ${level}\n`;
|
|
11
|
+
const contents = header + unset + scan(command, threshold);
|
|
12
|
+
await mkdir(dirname(hook), { recursive: true });
|
|
13
|
+
try {
|
|
14
|
+
await writeFile(hook, contents, { flag: "wx", mode: 0o755 });
|
|
15
|
+
}
|
|
16
|
+
catch (error) {
|
|
17
|
+
if (error.code !== "EEXIST")
|
|
18
|
+
throw error;
|
|
19
|
+
}
|
|
20
|
+
const refuse = () => new Error(`A pre-commit hook already exists at ${hook}.`);
|
|
21
|
+
const templates = REPORTABLE_SEVERITIES.flatMap((level) => [
|
|
22
|
+
header + unset + scan(command, level),
|
|
23
|
+
header +
|
|
24
|
+
"unset GIT_DIR GIT_WORK_TREE GIT_INDEX_FILE\n" +
|
|
25
|
+
scan(command, level),
|
|
26
|
+
header + scan(command, level),
|
|
27
|
+
header + scan("npx --no-install codex-security", level),
|
|
28
|
+
]);
|
|
29
|
+
const selected = await lstat(hook, { bigint: true });
|
|
30
|
+
if (!selected.isFile())
|
|
31
|
+
throw refuse();
|
|
32
|
+
const file = await open(hook, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
|
|
33
|
+
try {
|
|
34
|
+
const opened = await file.stat({ bigint: true });
|
|
35
|
+
if (!opened.isFile() ||
|
|
36
|
+
opened.dev !== selected.dev ||
|
|
37
|
+
opened.ino !== selected.ino ||
|
|
38
|
+
opened.nlink !== 1n ||
|
|
39
|
+
opened.size > Math.max(...templates.map((t) => Buffer.byteLength(t))))
|
|
40
|
+
throw refuse();
|
|
41
|
+
const previous = await file.readFile("utf8");
|
|
42
|
+
if (!templates.includes(previous))
|
|
43
|
+
throw refuse();
|
|
44
|
+
if (previous === contents) {
|
|
45
|
+
if (process.platform !== "win32") {
|
|
46
|
+
try {
|
|
47
|
+
await access(hook, constants.X_OK);
|
|
48
|
+
}
|
|
49
|
+
catch {
|
|
50
|
+
await file.chmod((Number(opened.mode) & 0o777) | 0o100);
|
|
51
|
+
await access(hook, constants.X_OK);
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
return;
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
finally {
|
|
58
|
+
// Windows can deny replacement while the destination is open.
|
|
59
|
+
await file.close();
|
|
60
|
+
}
|
|
61
|
+
const staged = `${hook}.${randomUUID()}.tmp`;
|
|
62
|
+
const replacement = await open(staged, "wx", 0o600);
|
|
63
|
+
try {
|
|
64
|
+
try {
|
|
65
|
+
await replacement.writeFile(contents);
|
|
66
|
+
if (process.platform !== "win32")
|
|
67
|
+
await replacement.chmod((Number(selected.mode) & 0o777) | 0o100);
|
|
68
|
+
}
|
|
69
|
+
finally {
|
|
70
|
+
await replacement.close();
|
|
71
|
+
}
|
|
72
|
+
const current = await lstat(hook, { bigint: true });
|
|
73
|
+
if (!current.isFile() ||
|
|
74
|
+
current.dev !== selected.dev ||
|
|
75
|
+
current.ino !== selected.ino ||
|
|
76
|
+
current.ctimeNs !== selected.ctimeNs ||
|
|
77
|
+
current.nlink !== selected.nlink)
|
|
78
|
+
throw refuse();
|
|
79
|
+
await rename(staged, hook);
|
|
80
|
+
if (process.platform !== "win32")
|
|
81
|
+
await access(hook, constants.X_OK);
|
|
82
|
+
}
|
|
83
|
+
finally {
|
|
84
|
+
await rm(staged, { force: true });
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
//# sourceMappingURL=cli-hook.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cli-hook.js","sourceRoot":"","sources":["../src/cli-hook.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { constants } from \"node:fs\";\nimport {\n access,\n lstat,\n mkdir,\n open,\n rename,\n rm,\n writeFile,\n} from \"node:fs/promises\";\nimport { dirname } from \"node:path\";\nimport {\n REPORTABLE_SEVERITIES,\n type FailureSeverity,\n} from \"./scan-settings.js\";\nimport { UNSUPPORTED_GIT_ENVIRONMENT } from \"./targets.js\";\n\nexport async function installManagedHook(\n hook: string,\n command: string,\n threshold: FailureSeverity,\n): Promise<void> {\n const header = \"#!/bin/sh\\nset -eu\\n\";\n const unset = `unset ${[...UNSUPPORTED_GIT_ENVIRONMENT].join(\" \")}\\n`;\n const scan = (launcher: string, level: FailureSeverity) =>\n `exec ${launcher} scan . --working-tree --fail-on-severity ${level}\\n`;\n const contents = header + unset + scan(command, threshold);\n await mkdir(dirname(hook), { recursive: true });\n try {\n await writeFile(hook, contents, { flag: \"wx\", mode: 0o755 });\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code !== \"EEXIST\") throw error;\n }\n\n const refuse = () =>\n new Error(`A pre-commit hook already exists at ${hook}.`);\n const templates = REPORTABLE_SEVERITIES.flatMap((level) => [\n header + unset + scan(command, level),\n header +\n \"unset GIT_DIR GIT_WORK_TREE GIT_INDEX_FILE\\n\" +\n scan(command, level),\n header + scan(command, level),\n header + scan(\"npx --no-install codex-security\", level),\n ]);\n const selected = await lstat(hook, { bigint: true });\n if (!selected.isFile()) throw refuse();\n const file = await open(\n hook,\n constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK,\n );\n try {\n const opened = await file.stat({ bigint: true });\n if (\n !opened.isFile() ||\n opened.dev !== selected.dev ||\n opened.ino !== selected.ino ||\n opened.nlink !== 1n ||\n opened.size > Math.max(...templates.map((t) => Buffer.byteLength(t)))\n )\n throw refuse();\n const previous = await file.readFile(\"utf8\");\n if (!templates.includes(previous)) throw refuse();\n if (previous === contents) {\n if (process.platform !== \"win32\") {\n try {\n await access(hook, constants.X_OK);\n } catch {\n await file.chmod((Number(opened.mode) & 0o777) | 0o100);\n await access(hook, constants.X_OK);\n }\n }\n return;\n }\n } finally {\n // Windows can deny replacement while the destination is open.\n await file.close();\n }\n\n const staged = `${hook}.${randomUUID()}.tmp`;\n const replacement = await open(staged, \"wx\", 0o600);\n try {\n try {\n await replacement.writeFile(contents);\n if (process.platform !== \"win32\")\n await replacement.chmod((Number(selected.mode) & 0o777) | 0o100);\n } finally {\n await replacement.close();\n }\n const current = await lstat(hook, { bigint: true });\n if (\n !current.isFile() ||\n current.dev !== selected.dev ||\n current.ino !== selected.ino ||\n current.ctimeNs !== selected.ctimeNs ||\n current.nlink !== selected.nlink\n )\n throw refuse();\n await rename(staged, hook);\n if (process.platform !== \"win32\") await access(hook, constants.X_OK);\n } finally {\n await rm(staged, { force: true });\n }\n}\n"]}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import { Cli, z } from "incur";
|
|
2
|
+
export declare const completionShell: z.ZodEnum<{
|
|
3
|
+
bash: "bash";
|
|
4
|
+
fish: "fish";
|
|
5
|
+
nushell: "nushell";
|
|
6
|
+
zsh: "zsh";
|
|
7
|
+
}>;
|
|
8
|
+
/** Complete shell words without dispatching or validating any command. */
|
|
9
|
+
export declare function completeCli(cli: Cli.Cli, cliOptions: Cli.create.Options, shell: z.infer<typeof completionShell>, argv: readonly string[]): string;
|
|
10
|
+
/** Incur dispatches its built-in writers before schema and version. Serve
|
|
11
|
+
* ordinary command groups so its normal parser and metadata handling run first. */
|
|
12
|
+
export declare function serveIntegration(argv: string[], cli: Cli.Cli, cliOptions: Cli.create.Options, output: Cli.serve.Options, command: string | undefined, literalArgs: readonly string[]): Promise<boolean>;
|
|
13
|
+
//# sourceMappingURL=cli-integrations.d.ts.map
|