@openai/codex-security 0.8.3 → 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 +36 -746
- package/_bundled_plugin/.codex-plugin/plugin.json +2 -0
- package/_bundled_plugin/.mcp.json +7 -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/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/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/focused-investigator.md +13 -0
- 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/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/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 +192 -352
- package/_bundled_plugin/scripts/dispatch_inventory_tool +7 -0
- package/_bundled_plugin/scripts/filesystem_identity.py +1 -0
- package/_bundled_plugin/scripts/finalize_scan_contract.py +182 -230
- package/_bundled_plugin/scripts/finding_preview.py +20 -0
- package/_bundled_plugin/scripts/launch_codex_security_mcp +55 -16
- package/_bundled_plugin/scripts/legacy_findings.py +148 -0
- package/_bundled_plugin/scripts/posix_scan_local_files.py +37 -1
- 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 +9 -2
- 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 +582 -20
- package/_bundled_plugin/scripts/workbench/__init__.py +1 -1
- package/_bundled_plugin/scripts/workbench/handoff.py +100 -23
- 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 +91 -7
- package/_bundled_plugin/scripts/workbench_cli.py +54 -14
- package/_bundled_plugin/scripts/workbench_constants.py +12 -0
- package/_bundled_plugin/scripts/workbench_coverage_receipts.py +3 -3
- package/_bundled_plugin/scripts/workbench_db.py +562 -303
- package/_bundled_plugin/scripts/workbench_feedback.py +57 -11
- 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 +238 -41
- package/_bundled_plugin/scripts/workbench_progress.py +169 -4
- package/_bundled_plugin/scripts/workbench_publication.py +16 -13
- package/_bundled_plugin/scripts/workbench_remediation.py +155 -2
- package/_bundled_plugin/scripts/workbench_saved_results.py +176 -81
- package/_bundled_plugin/scripts/workbench_scan_history.py +398 -174
- package/_bundled_plugin/scripts/workbench_scan_start.py +224 -31
- package/_bundled_plugin/scripts/workbench_scan_usage.py +675 -73
- package/_bundled_plugin/scripts/workbench_schema.py +258 -63
- package/_bundled_plugin/scripts/workbench_setup.py +14 -2
- 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 +594 -136
- package/_bundled_plugin/scripts/workbench_target_state.py +1110 -21
- package/_bundled_plugin/scripts/workbench_validation.py +43 -3
- package/_bundled_plugin/shared/workbench-history-repairs.json +77 -35
- package/_bundled_plugin/shared/workbench-migrations.json +100 -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 +2 -1
- package/_bundled_plugin/skills/publish-findings/SKILL.md +24 -153
- package/_bundled_plugin/skills/publish-findings/agents/openai.yaml +2 -2
- 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 +409 -0
- 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/_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/bin/codex-security.mjs +2 -2
- package/dist/api.d.ts +45 -5
- package/dist/api.d.ts.map +1 -1
- package/dist/api.js +1192 -427
- 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 +37 -18
- 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/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 +1 -1
- package/dist/blackduck-findings.d.ts.map +1 -1
- package/dist/blackduck-findings.js +24 -22
- 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/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/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-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-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 +11 -10
- 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 +16 -8
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +3382 -2017
- package/dist/cli.js.map +1 -1
- package/dist/cloud-publish.d.ts.map +1 -1
- package/dist/cloud-publish.js +35 -33
- 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 +19 -4
- package/dist/component-scan.d.ts.map +1 -1
- package/dist/component-scan.js +67 -9
- 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 +130 -67
- 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 +149 -19
- 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 +484 -149
- 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/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 +4 -2
- package/dist/deduplication/local.d.ts.map +1 -1
- package/dist/deduplication/local.js +9 -2
- package/dist/deduplication/local.js.map +1 -1
- package/dist/deduplication/refusal.d.ts.map +1 -1
- package/dist/deduplication/refusal.js +26 -5
- package/dist/deduplication/refusal.js.map +1 -1
- package/dist/deduplication/scan.d.ts +5 -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-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 +44 -19
- 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 +86 -45
- package/dist/endor-findings.js.map +1 -1
- package/dist/errors.d.ts +4 -2
- package/dist/errors.d.ts.map +1 -1
- package/dist/errors.js +15 -4
- 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 +5 -3
- package/dist/external-findings-import.d.ts.map +1 -1
- package/dist/external-findings-import.js +19 -7
- package/dist/external-findings-import.js.map +1 -1
- package/dist/external-findings-local.d.ts +69 -5
- package/dist/external-findings-local.d.ts.map +1 -1
- package/dist/external-findings-local.js +537 -108
- package/dist/external-findings-local.js.map +1 -1
- package/dist/external-findings-publish.d.ts +13 -6
- package/dist/external-findings-publish.d.ts.map +1 -1
- package/dist/external-findings-publish.js +895 -1142
- package/dist/external-findings-publish.js.map +1 -1
- package/dist/external-findings-read.d.ts +21 -2
- package/dist/external-findings-read.d.ts.map +1 -1
- package/dist/external-findings-read.js +130 -68
- 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 +54 -2
- package/dist/external-findings.js.map +1 -1
- package/dist/external-import-contract.d.ts +8 -12
- package/dist/external-import-contract.d.ts.map +1 -1
- package/dist/external-import-contract.js +51 -184
- 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 +18 -8
- 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 +73 -316
- 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-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/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/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 +21 -9
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +12 -3
- package/dist/index.js.map +1 -1
- package/dist/inspector-findings.d.ts.map +1 -1
- package/dist/inspector-findings.js +52 -86
- 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 +102 -32
- 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 -5
- package/dist/local-git-metadata.js.map +1 -1
- package/dist/multiscan.d.ts +10 -4
- package/dist/multiscan.d.ts.map +1 -1
- package/dist/multiscan.js +217 -102
- 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 +5 -2
- package/dist/opengrep-findings.d.ts.map +1 -1
- package/dist/opengrep-findings.js +54 -33
- 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 +99 -9
- package/dist/private-finding-import.d.ts.map +1 -1
- package/dist/private-finding-import.js +116 -152
- 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 +1 -1
- package/dist/provider-profile.d.ts.map +1 -1
- package/dist/provider-profile.js +12 -10
- 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/publication.d.ts +1 -1
- package/dist/publication.d.ts.map +1 -1
- package/dist/publication.js.map +1 -1
- 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/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 +1 -4
- package/dist/remediation.d.ts.map +1 -1
- package/dist/remediation.js +6 -8
- 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 +54 -6
- package/dist/runtime.d.ts.map +1 -1
- package/dist/runtime.js +1084 -256
- package/dist/runtime.js.map +1 -1
- package/dist/saved-scan-bootstrap.d.ts +7 -1
- package/dist/saved-scan-bootstrap.d.ts.map +1 -1
- package/dist/saved-scan-bootstrap.js +269 -114
- 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-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 +10 -5
- package/dist/scan-comparison.d.ts.map +1 -1
- package/dist/scan-comparison.js +66 -17
- package/dist/scan-comparison.js.map +1 -1
- package/dist/scan-dashboard.d.ts +7 -6
- package/dist/scan-dashboard.d.ts.map +1 -1
- package/dist/scan-dashboard.js +92 -43
- 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 +24 -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 +34 -28
- 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 +131 -78
- 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 +25 -13
- package/dist/scanner-import.d.ts.map +1 -1
- package/dist/scanner-import.js +216 -97
- 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 +26 -6
- 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 +72 -42
- 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 +157 -6
- package/dist/semgrep-platform-findings.d.ts.map +1 -1
- package/dist/semgrep-platform-findings.js +766 -103
- package/dist/semgrep-platform-findings.js.map +1 -1
- 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 +9 -2
- package/dist/snyk-findings.d.ts.map +1 -1
- package/dist/snyk-findings.js +90 -70
- package/dist/snyk-findings.js.map +1 -1
- package/dist/snyk-rest-findings.d.ts +59 -0
- package/dist/snyk-rest-findings.d.ts.map +1 -0
- package/dist/snyk-rest-findings.js +879 -0
- package/dist/snyk-rest-findings.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-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 +30 -34
- 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/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 +8 -1
- package/dist/targets.d.ts.map +1 -1
- package/dist/targets.js +131 -42
- package/dist/targets.js.map +1 -1
- package/dist/tenable-findings.d.ts +6 -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 +424 -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/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/validation-records.js +1 -1
- package/dist/validation-records.js.map +1 -1
- package/dist/veracode-findings.d.ts +1 -1
- package/dist/veracode-findings.d.ts.map +1 -1
- package/dist/veracode-findings.js +19 -6
- 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/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 +6 -2
- package/dist/wiz-findings.d.ts.map +1 -1
- package/dist/wiz-findings.js +65 -89
- package/dist/wiz-findings.js.map +1 -1
- package/docs/classify-severity-records.md +27 -12
- package/docs/cli.md +853 -639
- package/docs/dedupe-records.md +44 -24
- package/docs/findings-service.md +84 -44
- package/docs/hosted-remediation.md +27 -11
- package/docs/hosted-scans.md +50 -42
- package/docs/sdk.md +903 -0
- package/docs/telemetry.md +236 -0
- package/docs/validate-records.md +78 -44
- package/package.json +23 -16
- package/schemas/external-findings.schema.json +4 -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
- package/dist/reader-selection.d.ts +0 -13
- package/dist/reader-selection.d.ts.map +0 -1
- package/dist/reader-selection.js +0 -81
- package/dist/reader-selection.js.map +0 -1
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":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EACL,MAAM,EACN,KAAK,EACL,KAAK,EACL,IAAI,EACJ,MAAM,EACN,EAAE,EACF,SAAS,GACV,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,qBAAqB,GAEtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAY,EACZ,OAAe,EACf,SAA0B;IAE1B,MAAM,MAAM,GAAG,sBAAsB,CAAC;IACtC,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,2BAA2B,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;IACtE,MAAM,IAAI,GAAG,CAAC,QAAgB,EAAE,KAAsB,EAAE,EAAE,CACxD,QAAQ,QAAQ,6CAA6C,KAAK,IAAI,CAAC;IACzE,MAAM,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC3D,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC/D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,KAAK,CAAC;IACtE,CAAC;IAED,MAAM,MAAM,GAAG,GAAG,EAAE,CAClB,IAAI,KAAK,CAAC,uCAAuC,IAAI,GAAG,CAAC,CAAC;IAC5D,MAAM,SAAS,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;QACzD,MAAM,GAAG,KAAK,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC;QACrC,MAAM;YACJ,8CAA8C;YAC9C,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC;QACtB,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC;QAC7B,MAAM,GAAG,IAAI,CAAC,iCAAiC,EAAE,KAAK,CAAC;KACxD,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE;QAAE,MAAM,MAAM,EAAE,CAAC;IACvC,MAAM,IAAI,GAAG,MAAM,IAAI,CACrB,IAAI,EACJ,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAC,UAAU,GAAG,SAAS,CAAC,UAAU,CACjE,CAAC;IACF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,IACE,CAAC,MAAM,CAAC,MAAM,EAAE;YAChB,MAAM,CAAC,GAAG,KAAK,QAAQ,CAAC,GAAG;YAC3B,MAAM,CAAC,GAAG,KAAK,QAAQ,CAAC,GAAG;YAC3B,MAAM,CAAC,KAAK,KAAK,EAAE;YACnB,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;YAErE,MAAM,MAAM,EAAE,CAAC;QACjB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,MAAM,MAAM,EAAE,CAAC;QAClD,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC1B,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;gBACjC,IAAI,CAAC;oBACH,MAAM,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;gBACrC,CAAC;gBAAC,MAAM,CAAC;oBACP,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC;oBACxD,MAAM,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;gBACrC,CAAC;YACH,CAAC;YACD,OAAO;QACT,CAAC;IACH,CAAC;YAAS,CAAC;QACT,8DAA8D;QAC9D,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,MAAM,MAAM,GAAG,GAAG,IAAI,IAAI,UAAU,EAAE,MAAM,CAAC;IAC7C,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IACpD,IAAI,CAAC;QACH,IAAI,CAAC;YACH,MAAM,WAAW,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YACtC,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;gBAC9B,MAAM,WAAW,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC;QACrE,CAAC;gBAAS,CAAC;YACT,MAAM,WAAW,CAAC,KAAK,EAAE,CAAC;QAC5B,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,IACE,CAAC,OAAO,CAAC,MAAM,EAAE;YACjB,OAAO,CAAC,GAAG,KAAK,QAAQ,CAAC,GAAG;YAC5B,OAAO,CAAC,GAAG,KAAK,QAAQ,CAAC,GAAG;YAC5B,OAAO,CAAC,OAAO,KAAK,QAAQ,CAAC,OAAO;YACpC,OAAO,CAAC,KAAK,KAAK,QAAQ,CAAC,KAAK;YAEhC,MAAM,MAAM,EAAE,CAAC;QACjB,MAAM,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC3B,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;YAAE,MAAM,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;IACvE,CAAC;YAAS,CAAC;QACT,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,CAAC;AACH,CAAC","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
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cli-integrations.d.ts","sourceRoot":"","sources":["../src/cli-integrations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAiC,CAAC,EAAE,MAAM,OAAO,CAAC;AAQ9D,eAAO,MAAM,eAAe;;;;;EAA6C,CAAC;AA8O1E,0EAA0E;AAC1E,wBAAgB,WAAW,CACzB,GAAG,EAAE,GAAG,CAAC,GAAG,EACZ,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,OAAO,EAC9B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,EACtC,IAAI,EAAE,SAAS,MAAM,EAAE,UAuBxB;AAED;mFACmF;AACnF,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,GAAG,CAAC,GAAG,EACZ,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,OAAO,EAC9B,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,EACzB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,WAAW,EAAE,SAAS,MAAM,EAAE,GAC7B,OAAO,CAAC,OAAO,CAAC,CA4HlB"}
|
|
@@ -0,0 +1,333 @@
|
|
|
1
|
+
import { Cli, Completions, Help, SyncSkills, z } from "incur";
|
|
2
|
+
import { statSync } from "node:fs";
|
|
3
|
+
import { homedir } from "node:os";
|
|
4
|
+
import { join } from "node:path";
|
|
5
|
+
import { parseArgs } from "node:util";
|
|
6
|
+
import { registerMcp } from "./cli-mcp.js";
|
|
7
|
+
const cliName = "codex-security";
|
|
8
|
+
export const completionShell = z.enum(["bash", "fish", "nushell", "zsh"]);
|
|
9
|
+
const depth = z
|
|
10
|
+
.number()
|
|
11
|
+
.int()
|
|
12
|
+
.nonnegative()
|
|
13
|
+
.optional()
|
|
14
|
+
.describe("Grouping depth for generated skill files (default: 1).");
|
|
15
|
+
const scope = z
|
|
16
|
+
.enum(["project", "user"])
|
|
17
|
+
.optional()
|
|
18
|
+
.describe("Installation scope (default: user).");
|
|
19
|
+
const noGlobal = z
|
|
20
|
+
.boolean()
|
|
21
|
+
.optional()
|
|
22
|
+
.describe("Compatibility spelling for --scope project.");
|
|
23
|
+
function projectScope(options) {
|
|
24
|
+
if (options.noGlobal && options.scope === "user")
|
|
25
|
+
throw new Error("--scope user conflicts with --no-global.");
|
|
26
|
+
return options.noGlobal === true || options.scope === "project";
|
|
27
|
+
}
|
|
28
|
+
const descriptions = {
|
|
29
|
+
skills: "Manage generated CLI command guidance. The Codex Security plugin provides scan and remediation workflows.",
|
|
30
|
+
mcp: "Register the read-only info tool or check its server startup and catalog.",
|
|
31
|
+
};
|
|
32
|
+
// Node's tokenizer rejects surplus positionals and missing values such as
|
|
33
|
+
// --command --no-global before an installer can consume the scope switch.
|
|
34
|
+
const boolean = { type: "boolean" };
|
|
35
|
+
const string = { type: "string" };
|
|
36
|
+
const formatOptions = {
|
|
37
|
+
json: boolean,
|
|
38
|
+
format: string,
|
|
39
|
+
"full-output": boolean,
|
|
40
|
+
"filter-output": string,
|
|
41
|
+
"token-count": boolean,
|
|
42
|
+
"token-limit": string,
|
|
43
|
+
"token-offset": string,
|
|
44
|
+
};
|
|
45
|
+
const outputOptions = {
|
|
46
|
+
...formatOptions,
|
|
47
|
+
help: { ...boolean, short: "h" },
|
|
48
|
+
schema: boolean,
|
|
49
|
+
version: boolean,
|
|
50
|
+
llms: boolean,
|
|
51
|
+
"llms-full": boolean,
|
|
52
|
+
};
|
|
53
|
+
const options = {
|
|
54
|
+
...outputOptions,
|
|
55
|
+
depth: string,
|
|
56
|
+
scope: string,
|
|
57
|
+
all: boolean,
|
|
58
|
+
exec: string,
|
|
59
|
+
package: string,
|
|
60
|
+
arg: { ...string, multiple: true },
|
|
61
|
+
"no-global": boolean,
|
|
62
|
+
command: { ...string, short: "c" },
|
|
63
|
+
agent: { ...string, multiple: true },
|
|
64
|
+
};
|
|
65
|
+
function integrationGroups(cli, cliOptions, invocation) {
|
|
66
|
+
const { output, plain, full } = invocation ?? {};
|
|
67
|
+
const commands = Cli.toCommands.get(cli);
|
|
68
|
+
const config = {
|
|
69
|
+
sync: false,
|
|
70
|
+
update: false,
|
|
71
|
+
version: cliOptions.version,
|
|
72
|
+
};
|
|
73
|
+
const prefix = invocation ? cliName + " " : "";
|
|
74
|
+
async function builtin(args) {
|
|
75
|
+
let text = "";
|
|
76
|
+
await cli.serve(args, {
|
|
77
|
+
...output,
|
|
78
|
+
stdout: (chunk) => {
|
|
79
|
+
text += chunk;
|
|
80
|
+
},
|
|
81
|
+
});
|
|
82
|
+
return text.trimEnd();
|
|
83
|
+
}
|
|
84
|
+
const skills = Cli.create(prefix + "skills", {
|
|
85
|
+
...config,
|
|
86
|
+
description: descriptions.skills,
|
|
87
|
+
aliases: ["skill"],
|
|
88
|
+
})
|
|
89
|
+
.command("add", {
|
|
90
|
+
description: "Install generated CLI command guidance in the user profile or current project.",
|
|
91
|
+
options: z.object({ depth, scope, noGlobal }),
|
|
92
|
+
async run({ options }) {
|
|
93
|
+
const { depth } = options;
|
|
94
|
+
const local = projectScope(options);
|
|
95
|
+
if (plain)
|
|
96
|
+
return builtin([
|
|
97
|
+
"skills",
|
|
98
|
+
"add",
|
|
99
|
+
...(local ? ["--no-global"] : []),
|
|
100
|
+
...(depth === undefined ? [] : ["--depth", String(depth)]),
|
|
101
|
+
]);
|
|
102
|
+
const result = await SyncSkills.sync(cliName, commands, {
|
|
103
|
+
depth,
|
|
104
|
+
global: !local,
|
|
105
|
+
description: cliOptions.description,
|
|
106
|
+
});
|
|
107
|
+
return {
|
|
108
|
+
skills: result.paths,
|
|
109
|
+
...(full ? { agents: result.agents } : {}),
|
|
110
|
+
};
|
|
111
|
+
},
|
|
112
|
+
})
|
|
113
|
+
.command("list", {
|
|
114
|
+
aliases: ["ls"],
|
|
115
|
+
description: "List generated CLI guidance for one grouping depth. Use the same depth as skills add to check an installation.",
|
|
116
|
+
options: z.object({ depth }),
|
|
117
|
+
async run({ options: { depth } }) {
|
|
118
|
+
const entries = await SyncSkills.list(cliName, commands, {
|
|
119
|
+
depth,
|
|
120
|
+
description: cliOptions.description,
|
|
121
|
+
});
|
|
122
|
+
const roots = { project: process.cwd(), user: homedir() };
|
|
123
|
+
const skills = entries.map((skill) => {
|
|
124
|
+
const locations = Object.entries(roots).flatMap(([scope, root]) => {
|
|
125
|
+
const path = join(root, ".agents", "skills", skill.name, "SKILL.md");
|
|
126
|
+
return statSync(path, { throwIfNoEntry: false })?.isFile()
|
|
127
|
+
? [{ scope, path }]
|
|
128
|
+
: [];
|
|
129
|
+
});
|
|
130
|
+
return { ...skill, installed: locations.length > 0, locations };
|
|
131
|
+
});
|
|
132
|
+
if (!plain)
|
|
133
|
+
return skills;
|
|
134
|
+
return [
|
|
135
|
+
`Skill grouping depth: ${depth ?? 1}`,
|
|
136
|
+
...skills.map(({ name, installed, description, locations }) => [
|
|
137
|
+
` ${installed ? "✓" : "✗"} ${name} ${description ?? ""}`,
|
|
138
|
+
...locations.map(({ scope, path }) => ` ${scope}: ${path}`),
|
|
139
|
+
].join("\n")),
|
|
140
|
+
"",
|
|
141
|
+
`${skills.length} skill${skills.length === 1 ? "" : "s"} (${skills.filter((skill) => skill.installed).length} installed)`,
|
|
142
|
+
].join("\n");
|
|
143
|
+
},
|
|
144
|
+
});
|
|
145
|
+
const mcp = Cli.create(prefix + "mcp", {
|
|
146
|
+
...config,
|
|
147
|
+
description: descriptions.mcp,
|
|
148
|
+
})
|
|
149
|
+
.command("doctor", {
|
|
150
|
+
description: "Check the current CLI's MCP startup and tool catalog. Connect from your client to test its registered launcher.",
|
|
151
|
+
run: async () => JSON.parse(await builtin(["mcp", "doctor", "--json"])),
|
|
152
|
+
})
|
|
153
|
+
.command("add", {
|
|
154
|
+
description: "Register the read-only info tool with detected clients. Use --agent NAME or --all when no clients are detected. Amp supports user scope only.",
|
|
155
|
+
options: z.object({
|
|
156
|
+
agent: z
|
|
157
|
+
.array(z.string().min(1))
|
|
158
|
+
.optional()
|
|
159
|
+
.describe("Target a specific agent. Repeat to select more agents."),
|
|
160
|
+
all: z
|
|
161
|
+
.boolean()
|
|
162
|
+
.optional()
|
|
163
|
+
.describe("Register all compatible clients in the selected scope."),
|
|
164
|
+
exec: z
|
|
165
|
+
.string()
|
|
166
|
+
.min(1)
|
|
167
|
+
.optional()
|
|
168
|
+
.describe("Literal executable name or path."),
|
|
169
|
+
package: z
|
|
170
|
+
.string()
|
|
171
|
+
.min(1)
|
|
172
|
+
.optional()
|
|
173
|
+
.describe("Run this npm package with npx."),
|
|
174
|
+
arg: z
|
|
175
|
+
.array(z.string())
|
|
176
|
+
.optional()
|
|
177
|
+
.describe("Literal argument to --exec or --package. Repeat in order. Use --arg=VALUE for flags."),
|
|
178
|
+
command: z
|
|
179
|
+
.string()
|
|
180
|
+
.min(1)
|
|
181
|
+
.optional()
|
|
182
|
+
.describe("Launcher command line or HTTP(S) URL. For literal arguments use --exec and --arg."),
|
|
183
|
+
scope,
|
|
184
|
+
noGlobal,
|
|
185
|
+
}),
|
|
186
|
+
alias: { command: "c" },
|
|
187
|
+
async run({ options }) {
|
|
188
|
+
const result = await registerMcp(cliName, options, cliOptions.mcp.command, projectScope(options));
|
|
189
|
+
if (plain)
|
|
190
|
+
return [
|
|
191
|
+
`✓ Registered ${cliName} as MCP server`,
|
|
192
|
+
...(result.agents.length
|
|
193
|
+
? [` Agents: ${result.agents.join(", ")}`]
|
|
194
|
+
: []),
|
|
195
|
+
].join("\n");
|
|
196
|
+
return { name: cliName, ...result };
|
|
197
|
+
},
|
|
198
|
+
});
|
|
199
|
+
if (!invocation) {
|
|
200
|
+
cli
|
|
201
|
+
.command(skills)
|
|
202
|
+
.command(mcp)
|
|
203
|
+
.command("completions", {
|
|
204
|
+
description: "Generate a shell completion script.",
|
|
205
|
+
args: z.object({ shell: completionShell }),
|
|
206
|
+
run: () => undefined,
|
|
207
|
+
});
|
|
208
|
+
// Incur mounts aliases for leaf commands, but not for a whole group.
|
|
209
|
+
commands.set("skill", { _alias: true, target: "skills" });
|
|
210
|
+
}
|
|
211
|
+
return { skills, mcp };
|
|
212
|
+
}
|
|
213
|
+
/** Complete shell words without dispatching or validating any command. */
|
|
214
|
+
export function completeCli(cli, cliOptions, shell, argv) {
|
|
215
|
+
const words = argv[0] === "--" ? argv.slice(1) : [...argv];
|
|
216
|
+
if (words.length === 0)
|
|
217
|
+
return [cliName, ...(cliOptions.aliases ?? [])]
|
|
218
|
+
.map((name) => Completions.register(shell, name))
|
|
219
|
+
.join("\n");
|
|
220
|
+
const index = Number(process.env["_COMPLETE_INDEX"] ?? words.length - 1);
|
|
221
|
+
if (!Number.isSafeInteger(index) || index < 0 || index > words.length)
|
|
222
|
+
return "";
|
|
223
|
+
integrationGroups(cli, cliOptions);
|
|
224
|
+
const candidates = Completions.complete(Cli.toCommands.get(cli), undefined, words, index, {
|
|
225
|
+
schema: z.object({
|
|
226
|
+
format: z.enum(["toon", "json", "yaml", "md", "jsonl"]),
|
|
227
|
+
}),
|
|
228
|
+
});
|
|
229
|
+
return Completions.format(shell, candidates);
|
|
230
|
+
}
|
|
231
|
+
/** Incur dispatches its built-in writers before schema and version. Serve
|
|
232
|
+
* ordinary command groups so its normal parser and metadata handling run first. */
|
|
233
|
+
export async function serveIntegration(argv, cli, cliOptions, output, command, literalArgs) {
|
|
234
|
+
const manifest = (argv.includes("--llms") || argv.includes("--llms-full")) &&
|
|
235
|
+
!argv.some((arg) => ["--help", "-h", "--version", "--schema"].includes(arg));
|
|
236
|
+
const group = command === "skill" ? "skills" : command;
|
|
237
|
+
const integration = group === "mcp" || group === "skills";
|
|
238
|
+
if (!integration && !manifest && group !== "completions")
|
|
239
|
+
return false;
|
|
240
|
+
if (group === "completions") {
|
|
241
|
+
const [, shell, ...extra] = [
|
|
242
|
+
...parseArgs({
|
|
243
|
+
args: argv,
|
|
244
|
+
options: outputOptions,
|
|
245
|
+
allowPositionals: true,
|
|
246
|
+
}).positionals,
|
|
247
|
+
...literalArgs,
|
|
248
|
+
];
|
|
249
|
+
if (extra.length)
|
|
250
|
+
throw new Error("Unexpected positional argument for completions.");
|
|
251
|
+
if (shell !== undefined && !completionShell.safeParse(shell).success)
|
|
252
|
+
throw new Error(`Unknown shell. Supported: ${completionShell.options.join(", ")}.`);
|
|
253
|
+
if (argv.includes("--schema") || argv.includes("--version")) {
|
|
254
|
+
const section = Cli.create(cliName + " completions", {
|
|
255
|
+
version: cliOptions.version,
|
|
256
|
+
update: false,
|
|
257
|
+
sync: false,
|
|
258
|
+
args: z.object({ shell: completionShell }),
|
|
259
|
+
run: () => undefined,
|
|
260
|
+
});
|
|
261
|
+
await section.serve(argv.filter((arg) => arg !== group && arg !== shell), output);
|
|
262
|
+
return true;
|
|
263
|
+
}
|
|
264
|
+
if (!manifest) {
|
|
265
|
+
await cli.serve([...argv, ...literalArgs], output);
|
|
266
|
+
return true;
|
|
267
|
+
}
|
|
268
|
+
}
|
|
269
|
+
const { tokens, positionals, values } = parseArgs({
|
|
270
|
+
args: argv,
|
|
271
|
+
options,
|
|
272
|
+
allowPositionals: true,
|
|
273
|
+
tokens: true,
|
|
274
|
+
strict: integration,
|
|
275
|
+
});
|
|
276
|
+
const plain = !Object.keys(formatOptions).some((key) => Object.hasOwn(values, key));
|
|
277
|
+
const full = values["full-output"] === true;
|
|
278
|
+
const { skills, mcp } = integrationGroups(cli, cliOptions, manifest ? undefined : { output, plain, full });
|
|
279
|
+
if (integration) {
|
|
280
|
+
const section = group === "mcp" ? mcp : skills;
|
|
281
|
+
const [, verb, ...extra] = positionals;
|
|
282
|
+
if (literalArgs.length || extra.length)
|
|
283
|
+
throw new Error(`Unexpected positional argument for ${group}${verb ? " " + verb : ""}.`);
|
|
284
|
+
if (verb && !Cli.toCommands.get(section).has(verb)) {
|
|
285
|
+
await cli.serve([group, verb, "--help"], output);
|
|
286
|
+
return true;
|
|
287
|
+
}
|
|
288
|
+
}
|
|
289
|
+
if (manifest) {
|
|
290
|
+
// Put the mode first so a missing format/filter operand cannot consume it
|
|
291
|
+
// and fall through to a command handler.
|
|
292
|
+
const flag = argv.includes("--llms-full") ? "--llms-full" : "--llms";
|
|
293
|
+
await cli.serve([
|
|
294
|
+
flag,
|
|
295
|
+
...argv.filter((arg) => !["--llms", "--llms-full", "--update"].includes(arg)),
|
|
296
|
+
], output);
|
|
297
|
+
return true;
|
|
298
|
+
}
|
|
299
|
+
if (!integration)
|
|
300
|
+
return false;
|
|
301
|
+
const section = group === "mcp" ? mcp : skills;
|
|
302
|
+
const [, verb] = positionals;
|
|
303
|
+
if (!verb && !values.version) {
|
|
304
|
+
const invalid = tokens.find((token) => token.kind === "option" && !Object.hasOwn(outputOptions, token.name));
|
|
305
|
+
if (invalid?.kind === "option")
|
|
306
|
+
throw new Error(`Unknown option for ${group}: ${invalid.rawName}`);
|
|
307
|
+
const children = Array.from(Cli.toCommands.get(section)).flatMap(([name, entry]) => "description" in entry
|
|
308
|
+
? [{ name, description: entry.description }]
|
|
309
|
+
: []);
|
|
310
|
+
output.stdout?.(Help.formatRoot(`${cliName} ${group}`, {
|
|
311
|
+
aliases: section === skills ? ["skill"] : [],
|
|
312
|
+
description: descriptions[group],
|
|
313
|
+
commands: children,
|
|
314
|
+
}) + "\n");
|
|
315
|
+
return true;
|
|
316
|
+
}
|
|
317
|
+
// The public flag names a scope directly. Incur reserves --no-* for
|
|
318
|
+
// negation; pass its schema's field name after Node tokenizes the CLI flag.
|
|
319
|
+
const args = argv.slice();
|
|
320
|
+
const groupToken = tokens.find((token) => token.kind === "positional");
|
|
321
|
+
for (const token of tokens) {
|
|
322
|
+
if (token.kind !== "option")
|
|
323
|
+
continue;
|
|
324
|
+
if (token.name === "depth" && !token.value?.trim())
|
|
325
|
+
throw new Error("--depth requires a nonnegative integer.");
|
|
326
|
+
if (token.name === "no-global")
|
|
327
|
+
args[token.index] = "--noGlobal";
|
|
328
|
+
}
|
|
329
|
+
args.splice(groupToken.index, 1);
|
|
330
|
+
await section.serve(args, output);
|
|
331
|
+
return true;
|
|
332
|
+
}
|
|
333
|
+
//# sourceMappingURL=cli-integrations.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cli-integrations.js","sourceRoot":"","sources":["../src/cli-integrations.ts"],"names":[],"mappings":"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","sourcesContent":["import { Cli, Completions, Help, SyncSkills, z } from \"incur\";\nimport { statSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\nimport { parseArgs } from \"node:util\";\nimport { registerMcp } from \"./cli-mcp.js\";\n\nconst cliName = \"codex-security\";\nexport const completionShell = z.enum([\"bash\", \"fish\", \"nushell\", \"zsh\"]);\nconst depth = z\n .number()\n .int()\n .nonnegative()\n .optional()\n .describe(\"Grouping depth for generated skill files (default: 1).\");\nconst scope = z\n .enum([\"project\", \"user\"])\n .optional()\n .describe(\"Installation scope (default: user).\");\nconst noGlobal = z\n .boolean()\n .optional()\n .describe(\"Compatibility spelling for --scope project.\");\nfunction projectScope(options: {\n scope?: \"project\" | \"user\" | undefined;\n noGlobal?: boolean | undefined;\n}) {\n if (options.noGlobal && options.scope === \"user\")\n throw new Error(\"--scope user conflicts with --no-global.\");\n return options.noGlobal === true || options.scope === \"project\";\n}\n\nconst descriptions = {\n skills:\n \"Manage generated CLI command guidance. The Codex Security plugin provides scan and remediation workflows.\",\n mcp: \"Register the read-only info tool or check its server startup and catalog.\",\n};\n\n// Node's tokenizer rejects surplus positionals and missing values such as\n// --command --no-global before an installer can consume the scope switch.\nconst boolean = { type: \"boolean\" } as const;\nconst string = { type: \"string\" } as const;\nconst formatOptions = {\n json: boolean,\n format: string,\n \"full-output\": boolean,\n \"filter-output\": string,\n \"token-count\": boolean,\n \"token-limit\": string,\n \"token-offset\": string,\n};\nconst outputOptions = {\n ...formatOptions,\n help: { ...boolean, short: \"h\" },\n schema: boolean,\n version: boolean,\n llms: boolean,\n \"llms-full\": boolean,\n};\nconst options = {\n ...outputOptions,\n depth: string,\n scope: string,\n all: boolean,\n exec: string,\n package: string,\n arg: { ...string, multiple: true },\n \"no-global\": boolean,\n command: { ...string, short: \"c\" },\n agent: { ...string, multiple: true },\n} as const;\n\nfunction integrationGroups(\n cli: Cli.Cli,\n cliOptions: Cli.create.Options,\n invocation?: { output: Cli.serve.Options; plain: boolean; full?: boolean },\n) {\n const { output, plain, full } = invocation ?? {};\n const commands = Cli.toCommands.get(cli)!;\n const config = {\n sync: false,\n update: false,\n version: cliOptions.version,\n } as const;\n const prefix = invocation ? cliName + \" \" : \"\";\n async function builtin(args: string[]) {\n let text = \"\";\n await cli.serve(args, {\n ...output,\n stdout: (chunk) => {\n text += chunk;\n },\n });\n return text.trimEnd();\n }\n\n const skills = Cli.create(prefix + \"skills\", {\n ...config,\n description: descriptions.skills,\n aliases: [\"skill\"],\n })\n .command(\"add\", {\n description:\n \"Install generated CLI command guidance in the user profile or current project.\",\n options: z.object({ depth, scope, noGlobal }),\n async run({ options }) {\n const { depth } = options;\n const local = projectScope(options);\n if (plain)\n return builtin([\n \"skills\",\n \"add\",\n ...(local ? [\"--no-global\"] : []),\n ...(depth === undefined ? [] : [\"--depth\", String(depth)]),\n ]);\n const result = await SyncSkills.sync(cliName, commands, {\n depth,\n global: !local,\n description: cliOptions.description,\n });\n return {\n skills: result.paths,\n ...(full ? { agents: result.agents } : {}),\n };\n },\n })\n .command(\"list\", {\n aliases: [\"ls\"],\n description:\n \"List generated CLI guidance for one grouping depth. Use the same depth as skills add to check an installation.\",\n options: z.object({ depth }),\n async run({ options: { depth } }) {\n const entries = await SyncSkills.list(cliName, commands, {\n depth,\n description: cliOptions.description,\n });\n const roots = { project: process.cwd(), user: homedir() };\n const skills = entries.map((skill) => {\n const locations = Object.entries(roots).flatMap(([scope, root]) => {\n const path = join(\n root,\n \".agents\",\n \"skills\",\n skill.name,\n \"SKILL.md\",\n );\n return statSync(path, { throwIfNoEntry: false })?.isFile()\n ? [{ scope, path }]\n : [];\n });\n return { ...skill, installed: locations.length > 0, locations };\n });\n if (!plain) return skills;\n return [\n `Skill grouping depth: ${depth ?? 1}`,\n ...skills.map(({ name, installed, description, locations }) =>\n [\n ` ${installed ? \"✓\" : \"✗\"} ${name} ${description ?? \"\"}`,\n ...locations.map(({ scope, path }) => ` ${scope}: ${path}`),\n ].join(\"\\n\"),\n ),\n \"\",\n `${skills.length} skill${skills.length === 1 ? \"\" : \"s\"} (${skills.filter((skill) => skill.installed).length} installed)`,\n ].join(\"\\n\");\n },\n });\n const mcp = Cli.create(prefix + \"mcp\", {\n ...config,\n description: descriptions.mcp,\n })\n .command(\"doctor\", {\n description:\n \"Check the current CLI's MCP startup and tool catalog. Connect from your client to test its registered launcher.\",\n run: async () => JSON.parse(await builtin([\"mcp\", \"doctor\", \"--json\"])),\n })\n .command(\"add\", {\n description:\n \"Register the read-only info tool with detected clients. Use --agent NAME or --all when no clients are detected. Amp supports user scope only.\",\n options: z.object({\n agent: z\n .array(z.string().min(1))\n .optional()\n .describe(\"Target a specific agent. Repeat to select more agents.\"),\n all: z\n .boolean()\n .optional()\n .describe(\"Register all compatible clients in the selected scope.\"),\n exec: z\n .string()\n .min(1)\n .optional()\n .describe(\"Literal executable name or path.\"),\n package: z\n .string()\n .min(1)\n .optional()\n .describe(\"Run this npm package with npx.\"),\n arg: z\n .array(z.string())\n .optional()\n .describe(\n \"Literal argument to --exec or --package. Repeat in order. Use --arg=VALUE for flags.\",\n ),\n command: z\n .string()\n .min(1)\n .optional()\n .describe(\n \"Launcher command line or HTTP(S) URL. For literal arguments use --exec and --arg.\",\n ),\n scope,\n noGlobal,\n }),\n alias: { command: \"c\" },\n async run({ options }) {\n const result = await registerMcp(\n cliName,\n options,\n cliOptions.mcp!.command!,\n projectScope(options),\n );\n if (plain)\n return [\n `✓ Registered ${cliName} as MCP server`,\n ...(result.agents.length\n ? [` Agents: ${result.agents.join(\", \")}`]\n : []),\n ].join(\"\\n\");\n return { name: cliName, ...result };\n },\n });\n if (!invocation) {\n cli\n .command(skills)\n .command(mcp)\n .command(\"completions\", {\n description: \"Generate a shell completion script.\",\n args: z.object({ shell: completionShell }),\n run: () => undefined,\n });\n // Incur mounts aliases for leaf commands, but not for a whole group.\n commands.set(\"skill\", { _alias: true, target: \"skills\" });\n }\n return { skills, mcp };\n}\n\n/** Complete shell words without dispatching or validating any command. */\nexport function completeCli(\n cli: Cli.Cli,\n cliOptions: Cli.create.Options,\n shell: z.infer<typeof completionShell>,\n argv: readonly string[],\n) {\n const words = argv[0] === \"--\" ? argv.slice(1) : [...argv];\n if (words.length === 0)\n return [cliName, ...(cliOptions.aliases ?? [])]\n .map((name) => Completions.register(shell, name))\n .join(\"\\n\");\n const index = Number(process.env[\"_COMPLETE_INDEX\"] ?? words.length - 1);\n if (!Number.isSafeInteger(index) || index < 0 || index > words.length)\n return \"\";\n integrationGroups(cli, cliOptions);\n const candidates = Completions.complete(\n Cli.toCommands.get(cli)!,\n undefined,\n words,\n index,\n {\n schema: z.object({\n format: z.enum([\"toon\", \"json\", \"yaml\", \"md\", \"jsonl\"]),\n }),\n },\n );\n return Completions.format(shell, candidates);\n}\n\n/** Incur dispatches its built-in writers before schema and version. Serve\n * ordinary command groups so its normal parser and metadata handling run first. */\nexport async function serveIntegration(\n argv: string[],\n cli: Cli.Cli,\n cliOptions: Cli.create.Options,\n output: Cli.serve.Options,\n command: string | undefined,\n literalArgs: readonly string[],\n): Promise<boolean> {\n const manifest =\n (argv.includes(\"--llms\") || argv.includes(\"--llms-full\")) &&\n !argv.some((arg) =>\n [\"--help\", \"-h\", \"--version\", \"--schema\"].includes(arg),\n );\n const group = command === \"skill\" ? \"skills\" : command;\n const integration = group === \"mcp\" || group === \"skills\";\n if (!integration && !manifest && group !== \"completions\") return false;\n if (group === \"completions\") {\n const [, shell, ...extra] = [\n ...parseArgs({\n args: argv,\n options: outputOptions,\n allowPositionals: true,\n }).positionals,\n ...literalArgs,\n ];\n if (extra.length)\n throw new Error(\"Unexpected positional argument for completions.\");\n if (shell !== undefined && !completionShell.safeParse(shell).success)\n throw new Error(\n `Unknown shell. Supported: ${completionShell.options.join(\", \")}.`,\n );\n if (argv.includes(\"--schema\") || argv.includes(\"--version\")) {\n const section = Cli.create(cliName + \" completions\", {\n version: cliOptions.version,\n update: false,\n sync: false,\n args: z.object({ shell: completionShell }),\n run: () => undefined,\n });\n await section.serve(\n argv.filter((arg) => arg !== group && arg !== shell),\n output,\n );\n return true;\n }\n if (!manifest) {\n await cli.serve([...argv, ...literalArgs], output);\n return true;\n }\n }\n const { tokens, positionals, values } = parseArgs({\n args: argv,\n options,\n allowPositionals: true,\n tokens: true,\n strict: integration,\n });\n const plain = !Object.keys(formatOptions).some((key) =>\n Object.hasOwn(values, key),\n );\n const full = values[\"full-output\"] === true;\n const { skills, mcp } = integrationGroups(\n cli,\n cliOptions,\n manifest ? undefined : { output, plain, full },\n );\n if (integration) {\n const section = group === \"mcp\" ? mcp : skills;\n const [, verb, ...extra] = positionals;\n if (literalArgs.length || extra.length)\n throw new Error(\n `Unexpected positional argument for ${group}${verb ? \" \" + verb : \"\"}.`,\n );\n if (verb && !Cli.toCommands.get(section)!.has(verb)) {\n await cli.serve([group, verb, \"--help\"], output);\n return true;\n }\n }\n if (manifest) {\n // Put the mode first so a missing format/filter operand cannot consume it\n // and fall through to a command handler.\n const flag = argv.includes(\"--llms-full\") ? \"--llms-full\" : \"--llms\";\n await cli.serve(\n [\n flag,\n ...argv.filter(\n (arg) => ![\"--llms\", \"--llms-full\", \"--update\"].includes(arg),\n ),\n ],\n output,\n );\n return true;\n }\n if (!integration) return false;\n const section = group === \"mcp\" ? mcp : skills;\n const [, verb] = positionals;\n if (!verb && !values.version) {\n const invalid = tokens.find(\n (token) =>\n token.kind === \"option\" && !Object.hasOwn(outputOptions, token.name),\n );\n if (invalid?.kind === \"option\")\n throw new Error(`Unknown option for ${group}: ${invalid.rawName}`);\n const children = Array.from(Cli.toCommands.get(section)!).flatMap(\n ([name, entry]) =>\n \"description\" in entry\n ? [{ name, description: entry.description }]\n : [],\n );\n output.stdout?.(\n Help.formatRoot(`${cliName} ${group}`, {\n aliases: section === skills ? [\"skill\"] : [],\n description: descriptions[group],\n commands: children,\n }) + \"\\n\",\n );\n return true;\n }\n // The public flag names a scope directly. Incur reserves --no-* for\n // negation; pass its schema's field name after Node tokenizes the CLI flag.\n const args = argv.slice();\n const groupToken = tokens.find((token) => token.kind === \"positional\")!;\n for (const token of tokens) {\n if (token.kind !== \"option\") continue;\n if (token.name === \"depth\" && !token.value?.trim())\n throw new Error(\"--depth requires a nonnegative integer.\");\n if (token.name === \"no-global\") args[token.index] = \"--noGlobal\";\n }\n args.splice(groupToken.index, 1);\n await section.serve(args, output);\n return true;\n}\n"]}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
type Launcher = {
|
|
2
|
+
command?: string | undefined;
|
|
3
|
+
exec?: string | undefined;
|
|
4
|
+
package?: string | undefined;
|
|
5
|
+
arg?: string[] | undefined;
|
|
6
|
+
};
|
|
7
|
+
export declare function registerMcp(cliName: string, options: Launcher & {
|
|
8
|
+
agent?: string[] | undefined;
|
|
9
|
+
all?: boolean | undefined;
|
|
10
|
+
}, defaultCommand: string, local: boolean): Promise<{
|
|
11
|
+
command: string;
|
|
12
|
+
agents: string[];
|
|
13
|
+
}>;
|
|
14
|
+
export {};
|
|
15
|
+
//# sourceMappingURL=cli-mcp.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"cli-mcp.d.ts","sourceRoot":"","sources":["../src/cli-mcp.ts"],"names":[],"mappings":"AAmCA,KAAK,QAAQ,GAAG;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CAC5B,CAAC;AA+EF,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,QAAQ,GAAG;IAClB,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC7B,GAAG,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC3B,EACD,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,OAAO;;;GAyGf"}
|