blackveil-dns 2.13.0 → 3.100.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +1 -1
- package/README.md +237 -62
- package/dist/cli.js +1098 -0
- package/dist/cli.js.map +1 -0
- package/dist/index.js +10011 -2433
- package/dist/index.js.map +1 -1
- package/dist/stdio.js +33244 -9766
- package/dist/stdio.js.map +1 -1
- package/package.json +101 -21
- package/.claude/settings.json +0 -61
- package/.cursorrules +0 -1
- package/.devcontainer/Dockerfile +0 -17
- package/.devcontainer/devcontainer.json +0 -18
- package/.editorconfig +0 -12
- package/.gitattributes +0 -24
- package/.githooks/blocked-patterns +0 -13
- package/.githooks/pre-commit +0 -127
- package/.github/CODEOWNERS +0 -11
- package/.github/ISSUE_TEMPLATE/bug_report.yml +0 -99
- package/.github/ISSUE_TEMPLATE/config.yml +0 -11
- package/.github/ISSUE_TEMPLATE/feature_request.yml +0 -51
- package/.github/PULL_REQUEST_TEMPLATE.md +0 -30
- package/.github/copilot-instructions.md +0 -73
- package/.github/dependabot.yml +0 -22
- package/.github/instructions/scan-orchestration.instructions.md +0 -56
- package/.github/instructions/schemas.instructions.md +0 -52
- package/.github/instructions/security.instructions.md +0 -77
- package/.github/instructions/tests.instructions.md +0 -31
- package/.github/instructions/tools.instructions.md +0 -55
- package/.github/workflows/auto-deploy-main.yml.disabled +0 -145
- package/.github/workflows/ci-contract.yml +0 -47
- package/.github/workflows/ci.yml +0 -53
- package/.github/workflows/deploy-hook.yml +0 -113
- package/.github/workflows/dns-security.yml +0 -32
- package/.github/workflows/publish.yml +0 -275
- package/.github/workflows/repo-hygiene.yml +0 -121
- package/.github/workflows/security.yml +0 -62
- package/.github/workflows/triage-issues.yml +0 -82
- package/.gitleaks.toml +0 -190
- package/.intent/.gitignore +0 -5
- package/.intent/config.json +0 -88
- package/.nvmrc +0 -1
- package/.phase2-queue/baseline.txt +0 -1
- package/.prettierrc +0 -6
- package/CHANGELOG.md +0 -793
- package/CLAUDE.md +0 -580
- package/CODE_OF_CONDUCT.md +0 -133
- package/CONTRIBUTING.md +0 -63
- package/SECURITY.md +0 -66
- package/SUPPORT.md +0 -17
- package/assets/brave-score.png +0 -0
- package/assets/bv-logo-full.png +0 -0
- package/assets/bv-logo-mark.png +0 -0
- package/assets/our-listing-final.png +0 -0
- package/assets/smithery-listing.png +0 -0
- package/assets/smithery-score-2.png +0 -0
- package/assets/smithery-score-hover.png +0 -0
- package/assets/smithery-score.png +0 -0
- package/assets/supabase-score.png +0 -0
- package/conductor/index.md +0 -1
- package/conductor/registrar-commercial-models.md +0 -64
- package/crates/bv-wasm-core/Cargo.lock +0 -177
- package/crates/bv-wasm-core/Cargo.toml +0 -12
- package/crates/bv-wasm-core/src/compact.rs +0 -60
- package/crates/bv-wasm-core/src/lib.rs +0 -116
- package/crates/bv-wasm-core/src/permissions.rs +0 -106
- package/dist/index.d.ts +0 -500
- package/dist/stdio.d.ts +0 -12
- package/docs/client-setup.md +0 -587
- package/docs/scoring.md +0 -245
- package/docs/style-guide.md +0 -69
- package/docs/tenant-Capacity-and-Discovery-Design.md +0 -267
- package/docs/tenant-Scalable-Architecture-Design.md +0 -639
- package/docs/tenant-ops-runbook.md +0 -191
- package/docs/troubleshooting.md +0 -392
- package/eslint.config.mjs +0 -21
- package/examples/slack-discord-webhook/README.md +0 -38
- package/examples/slack-discord-webhook/worker.ts +0 -133
- package/examples/slack-discord-webhook/wrangler.toml +0 -11
- package/extensions/vscode/.vscodeignore +0 -2
- package/extensions/vscode/CHANGELOG.md +0 -8
- package/extensions/vscode/LICENSE +0 -76
- package/extensions/vscode/README.md +0 -105
- package/extensions/vscode/icon.png +0 -0
- package/extensions/vscode/package.json +0 -49
- package/packages/dns-checks/LICENSE +0 -76
- package/packages/dns-checks/README.md +0 -61
- package/packages/dns-checks/package.json +0 -39
- package/packages/dns-checks/src/__tests__/check-utils.test.ts +0 -188
- package/packages/dns-checks/src/__tests__/checks/check-dkim.test.ts +0 -54
- package/packages/dns-checks/src/__tests__/checks/check-dmarc.test.ts +0 -70
- package/packages/dns-checks/src/__tests__/checks/check-dnssec.test.ts +0 -56
- package/packages/dns-checks/src/__tests__/checks/check-remaining.test.ts +0 -244
- package/packages/dns-checks/src/__tests__/checks/check-spf.test.ts +0 -114
- package/packages/dns-checks/src/__tests__/scoring/generic-engine.spec.ts +0 -858
- package/packages/dns-checks/src/__tests__/scoring/score-determinism.spec.ts +0 -73
- package/packages/dns-checks/src/__tests__/scoring/scoring-config.spec.ts +0 -194
- package/packages/dns-checks/src/__tests__/scoring/scoring-engine.spec.ts +0 -137
- package/packages/dns-checks/src/__tests__/scoring/scoring-model.spec.ts +0 -46
- package/packages/dns-checks/src/__tests__/scoring/scoring-profiles.spec.ts +0 -316
- package/packages/dns-checks/src/__tests__/scoring-schemas.test.ts +0 -307
- package/packages/dns-checks/src/check-utils.ts +0 -44
- package/packages/dns-checks/src/checks/caa-analysis.ts +0 -126
- package/packages/dns-checks/src/checks/check-bimi.ts +0 -305
- package/packages/dns-checks/src/checks/check-caa.ts +0 -63
- package/packages/dns-checks/src/checks/check-dane-https.ts +0 -88
- package/packages/dns-checks/src/checks/check-dane.ts +0 -110
- package/packages/dns-checks/src/checks/check-dkim.ts +0 -261
- package/packages/dns-checks/src/checks/check-dmarc.ts +0 -370
- package/packages/dns-checks/src/checks/check-dnssec.ts +0 -131
- package/packages/dns-checks/src/checks/check-http-security.ts +0 -187
- package/packages/dns-checks/src/checks/check-mta-sts.ts +0 -195
- package/packages/dns-checks/src/checks/check-mx.ts +0 -130
- package/packages/dns-checks/src/checks/check-ns.ts +0 -133
- package/packages/dns-checks/src/checks/check-spf.ts +0 -271
- package/packages/dns-checks/src/checks/check-ssl.ts +0 -95
- package/packages/dns-checks/src/checks/check-subdomailing.ts +0 -77
- package/packages/dns-checks/src/checks/check-subdomain-takeover.ts +0 -45
- package/packages/dns-checks/src/checks/check-svcb-https.ts +0 -246
- package/packages/dns-checks/src/checks/check-tlsrpt.ts +0 -112
- package/packages/dns-checks/src/checks/dane-analysis.ts +0 -203
- package/packages/dns-checks/src/checks/dkim-analysis.ts +0 -102
- package/packages/dns-checks/src/checks/dmarc-utils.ts +0 -126
- package/packages/dns-checks/src/checks/dnssec-analysis.ts +0 -237
- package/packages/dns-checks/src/checks/http-security-analysis.ts +0 -230
- package/packages/dns-checks/src/checks/index.ts +0 -36
- package/packages/dns-checks/src/checks/mta-sts-analysis.ts +0 -259
- package/packages/dns-checks/src/checks/mx-analysis.ts +0 -63
- package/packages/dns-checks/src/checks/ns-analysis.ts +0 -171
- package/packages/dns-checks/src/checks/spf-analysis.ts +0 -211
- package/packages/dns-checks/src/checks/spf-trust-surface.ts +0 -141
- package/packages/dns-checks/src/checks/ssl-analysis.ts +0 -111
- package/packages/dns-checks/src/checks/subdomailing-analysis.ts +0 -262
- package/packages/dns-checks/src/checks/subdomain-takeover-analysis.ts +0 -217
- package/packages/dns-checks/src/index.ts +0 -73
- package/packages/dns-checks/src/schemas/scoring.ts +0 -52
- package/packages/dns-checks/src/scoring/config.ts +0 -346
- package/packages/dns-checks/src/scoring/engine.ts +0 -293
- package/packages/dns-checks/src/scoring/generic.ts +0 -317
- package/packages/dns-checks/src/scoring/index.ts +0 -56
- package/packages/dns-checks/src/scoring/model.ts +0 -133
- package/packages/dns-checks/src/scoring/profiles.ts +0 -332
- package/packages/dns-checks/src/types.ts +0 -172
- package/packages/dns-checks/tsconfig.json +0 -15
- package/packages/dns-checks/tsup.config.ts +0 -14
- package/packages/dns-checks/vitest.config.ts +0 -8
- package/public/index.html +0 -45
- package/scripts/benchmark-doh.mjs +0 -216
- package/scripts/benchmark.sh +0 -151
- package/scripts/chaos/chaos-run.py +0 -393
- package/scripts/chaos/chaos-test-clients.py +0 -884
- package/scripts/chaos/chaos-test-msp.py +0 -745
- package/scripts/chaos/chaos-test-v205.py +0 -829
- package/scripts/chaos/chaos-test-v210.py +0 -2038
- package/scripts/chaos/chaos-test-wasm.py +0 -65
- package/scripts/chaos/chaos-test.py +0 -952
- package/scripts/chaos/score-stability-test.py +0 -298
- package/scripts/chaos/tenant-chaos-v3.py +0 -119
- package/scripts/context-usage-test.py +0 -281
- package/scripts/conversation-sim.py +0 -421
- package/scripts/deploy-private.mjs +0 -22
- package/scripts/generate-report.sh +0 -42
- package/scripts/inject-private-config.cjs +0 -41
- package/scripts/maintenance/dispatch_all.sh +0 -26
- package/scripts/maintenance/fix_wrangler.py +0 -32
- package/scripts/maintenance/run_rescan_prod.py +0 -34
- package/scripts/maintenance/run_sync_batches.py +0 -56
- package/scripts/maintenance/run_sync_test.py +0 -27
- package/scripts/maintenance/run_test_msg.py +0 -22
- package/scripts/maintenance/test_analytics_stream.js +0 -3
- package/scripts/maintenance/update_wrangler.cjs +0 -22
- package/scripts/maintenance/update_wrangler.js +0 -22
- package/scripts/maintenance/validate-internal-deps.mjs +0 -49
- package/scripts/oauth/README.md +0 -101
- package/scripts/oauth/prod-probe.py +0 -329
- package/scripts/output-usage-test.py +0 -221
- package/scripts/pressure-chaos-test.mjs +0 -481
- package/scripts/tenants/add_consumer.js +0 -17
- package/scripts/tenants/calibrate.mjs +0 -206
- package/scripts/tenants/provision-tenant.mjs +0 -578
- package/scripts/tenants/register_domains.py +0 -27
- package/scripts/tenants/sql/register_0.sql +0 -1
- package/scripts/tenants/sql/register_1.sql +0 -1
- package/scripts/tenants/sql/register_2.sql +0 -1
- package/scripts/tenants/sql/register_3.sql +0 -1
- package/scripts/tenants/sql/register_4.sql +0 -1
- package/scripts/tenants/sql/register_5.sql +0 -1
- package/scripts/tenants/sql/register_6.sql +0 -1
- package/scripts/tenants/sql/register_7.sql +0 -1
- package/scripts/tenants/sql/register_8.sql +0 -1
- package/scripts/tenants/sql/register_9.sql +0 -1
- package/scripts/tranco-deep-2026-04-05_12h42m.json +0 -47002
- package/scripts/tranco-deep-scan.mjs +0 -307
- package/scripts/tranco-scan-2026-04-05_12h14m.json +0 -6002
- package/scripts/tranco-scan-2026-04-06_02h49m.json +0 -602
- package/scripts/tranco-scan-2026-04-07_13h30m.json +0 -1202
- package/scripts/tranco-scan.mjs +0 -253
- package/scripts/trial-key.mjs +0 -346
- package/server.json +0 -35
- package/smithery.yaml +0 -13
- package/src/handlers/prompts.ts +0 -279
- package/src/handlers/resources.ts +0 -283
- package/src/handlers/tool-args.ts +0 -150
- package/src/handlers/tool-execution.ts +0 -107
- package/src/handlers/tool-formatters.ts +0 -94
- package/src/handlers/tool-schemas.ts +0 -9
- package/src/handlers/tools.ts +0 -529
- package/src/index.ts +0 -794
- package/src/internal.ts +0 -666
- package/src/lib/adaptive-weights.ts +0 -246
- package/src/lib/alerting.ts +0 -103
- package/src/lib/analytics-engine.ts +0 -33
- package/src/lib/analytics-queries.ts +0 -399
- package/src/lib/analytics.ts +0 -310
- package/src/lib/audit.ts +0 -56
- package/src/lib/auth.ts +0 -52
- package/src/lib/badge.ts +0 -94
- package/src/lib/cache.ts +0 -310
- package/src/lib/category-interactions.ts +0 -154
- package/src/lib/circuit-breaker.ts +0 -101
- package/src/lib/client-detection.ts +0 -31
- package/src/lib/config.ts +0 -370
- package/src/lib/context-profiles.ts +0 -16
- package/src/lib/db/schema.ts +0 -77
- package/src/lib/dns-multi-resolver.ts +0 -218
- package/src/lib/dns-query-adapter.ts +0 -18
- package/src/lib/dns-records.ts +0 -233
- package/src/lib/dns-transport.ts +0 -237
- package/src/lib/dns-types.ts +0 -91
- package/src/lib/dns.ts +0 -27
- package/src/lib/fuzzing-counter.ts +0 -79
- package/src/lib/fuzzing-detector.ts +0 -115
- package/src/lib/hooks/analytics-stream.ts +0 -28
- package/src/lib/ip-utils.ts +0 -70
- package/src/lib/json-rpc.ts +0 -67
- package/src/lib/legacy-sse.ts +0 -185
- package/src/lib/log.ts +0 -113
- package/src/lib/output-sanitize.ts +0 -40
- package/src/lib/profile-accumulator.ts +0 -830
- package/src/lib/provider-signature-source.ts +0 -191
- package/src/lib/provider-signatures.ts +0 -134
- package/src/lib/public-suffix.ts +0 -131
- package/src/lib/quota-coordinator.ts +0 -446
- package/src/lib/rate-limiter-memory.ts +0 -163
- package/src/lib/rate-limiter.ts +0 -528
- package/src/lib/safe-fetch.ts +0 -42
- package/src/lib/sanitize.ts +0 -245
- package/src/lib/scoring-config.ts +0 -36
- package/src/lib/scoring-engine.ts +0 -15
- package/src/lib/scoring-model.ts +0 -26
- package/src/lib/scoring.ts +0 -58
- package/src/lib/semaphore.ts +0 -101
- package/src/lib/server-version.ts +0 -4
- package/src/lib/session-memory.ts +0 -177
- package/src/lib/session.ts +0 -295
- package/src/lib/sse.ts +0 -174
- package/src/lib/tier-auth.ts +0 -237
- package/src/lib/trial-keys.ts +0 -217
- package/src/mcp/dispatch.ts +0 -222
- package/src/mcp/execute.ts +0 -680
- package/src/mcp/request.ts +0 -152
- package/src/mcp/route-gates.ts +0 -119
- package/src/oauth/authorize.ts +0 -268
- package/src/oauth/discovery.ts +0 -48
- package/src/oauth/entitlements.ts +0 -77
- package/src/oauth/jwt.ts +0 -142
- package/src/oauth/register.ts +0 -72
- package/src/oauth/storage.ts +0 -66
- package/src/oauth/token.ts +0 -171
- package/src/package.ts +0 -59
- package/src/scheduled.ts +0 -310
- package/src/schemas/alerting.ts +0 -49
- package/src/schemas/audit.ts +0 -39
- package/src/schemas/auth.ts +0 -27
- package/src/schemas/dns.ts +0 -49
- package/src/schemas/internal.ts +0 -26
- package/src/schemas/json-rpc.ts +0 -20
- package/src/schemas/oauth.ts +0 -120
- package/src/schemas/primitives.ts +0 -58
- package/src/schemas/session.ts +0 -9
- package/src/schemas/tenant-alerts.ts +0 -118
- package/src/schemas/tenant-internal.ts +0 -143
- package/src/schemas/tool-args.ts +0 -270
- package/src/schemas/tool-definitions.ts +0 -452
- package/src/stdio.ts +0 -183
- package/src/tenants/adapters/tenant-d1.ts +0 -51
- package/src/tenants/adapters/tenant-kv.ts +0 -64
- package/src/tenants/adapters/tenant-r2.ts +0 -69
- package/src/tenants/alerts/diff.ts +0 -201
- package/src/tenants/alerts/index.ts +0 -12
- package/src/tenants/alerts/webhook.ts +0 -141
- package/src/tenants/analytics-stream.ts +0 -26
- package/src/tenants/audit.ts +0 -123
- package/src/tenants/db/drizzle.registry.config.ts +0 -18
- package/src/tenants/db/drizzle.tenant.config.ts +0 -21
- package/src/tenants/db/index.ts +0 -19
- package/src/tenants/db/migrations/registry/0000_minor_skaar.sql +0 -46
- package/src/tenants/db/migrations/registry/0001_wet_warhawk.sql +0 -23
- package/src/tenants/db/migrations/registry/0002_big_speedball.sql +0 -17
- package/src/tenants/db/migrations/registry/meta/0000_snapshot.json +0 -330
- package/src/tenants/db/migrations/registry/meta/0001_snapshot.json +0 -498
- package/src/tenants/db/migrations/registry/meta/0002_snapshot.json +0 -624
- package/src/tenants/db/migrations/registry/meta/_journal.json +0 -27
- package/src/tenants/db/migrations/tenant/0000_clear_clea.sql +0 -54
- package/src/tenants/db/migrations/tenant/0001_clumsy_master_mold.sql +0 -3
- package/src/tenants/db/migrations/tenant/meta/0000_snapshot.json +0 -375
- package/src/tenants/db/migrations/tenant/meta/0001_snapshot.json +0 -397
- package/src/tenants/db/migrations/tenant/meta/_journal.json +0 -20
- package/src/tenants/db/schema/registry.ts +0 -154
- package/src/tenants/db/schema/tenant.ts +0 -106
- package/src/tenants/discovery/dkim-key-reuse.ts +0 -250
- package/src/tenants/discovery/dmarc-rua-miner.ts +0 -186
- package/src/tenants/discovery/index.ts +0 -31
- package/src/tenants/discovery/ns-correlator.ts +0 -155
- package/src/tenants/discovery/san-correlator.ts +0 -212
- package/src/tenants/dns-fingerprint.ts +0 -313
- package/src/tenants/monitoring/index.ts +0 -17
- package/src/tenants/per-tenant-rate-limit.ts +0 -148
- package/src/tenants/queue-consumer.ts +0 -375
- package/src/tenants/routes.ts +0 -1014
- package/src/tenants/scheduled-handlers.ts +0 -550
- package/src/tenants/tenant-resolver.ts +0 -143
- package/src/tools/analyze-drift.ts +0 -235
- package/src/tools/assess-spoofability.ts +0 -224
- package/src/tools/batch-scan.ts +0 -163
- package/src/tools/caa-analysis.ts +0 -72
- package/src/tools/check-bimi.ts +0 -30
- package/src/tools/check-caa.ts +0 -23
- package/src/tools/check-cymru-asn.ts +0 -175
- package/src/tools/check-dane-https.ts +0 -29
- package/src/tools/check-dane.ts +0 -29
- package/src/tools/check-dbl.ts +0 -251
- package/src/tools/check-dkim.ts +0 -98
- package/src/tools/check-dmarc.ts +0 -25
- package/src/tools/check-dnssec-chain.ts +0 -284
- package/src/tools/check-dnssec.ts +0 -171
- package/src/tools/check-fast-flux.ts +0 -168
- package/src/tools/check-http-security.ts +0 -339
- package/src/tools/check-lookalikes.ts +0 -379
- package/src/tools/check-mta-sts.ts +0 -24
- package/src/tools/check-mx-reputation.ts +0 -174
- package/src/tools/check-mx.ts +0 -117
- package/src/tools/check-ns.ts +0 -30
- package/src/tools/check-nsec-walkability.ts +0 -173
- package/src/tools/check-rbl.ts +0 -235
- package/src/tools/check-rdap-lookup.ts +0 -333
- package/src/tools/check-resolver-consistency.ts +0 -151
- package/src/tools/check-shadow-domains.ts +0 -517
- package/src/tools/check-spf.ts +0 -48
- package/src/tools/check-srv.ts +0 -75
- package/src/tools/check-ssl.ts +0 -18
- package/src/tools/check-subdomailing.ts +0 -22
- package/src/tools/check-subdomain-takeover.ts +0 -24
- package/src/tools/check-svcb-https.ts +0 -22
- package/src/tools/check-tlsrpt.ts +0 -23
- package/src/tools/check-txt-hygiene.ts +0 -364
- package/src/tools/check-zone-hygiene.ts +0 -154
- package/src/tools/compare-baseline.ts +0 -199
- package/src/tools/compare-domains.ts +0 -182
- package/src/tools/dane-analysis.ts +0 -172
- package/src/tools/discover-brand-domains.ts +0 -377
- package/src/tools/discover-subdomains.ts +0 -487
- package/src/tools/dkim-analysis.ts +0 -86
- package/src/tools/dmarc-utils.ts +0 -114
- package/src/tools/dnssec-analysis.ts +0 -123
- package/src/tools/explain-finding-data.ts +0 -766
- package/src/tools/explain-finding.ts +0 -181
- package/src/tools/generate-fix-plan.ts +0 -196
- package/src/tools/generate-records.ts +0 -412
- package/src/tools/generate-rollout-plan.ts +0 -342
- package/src/tools/http-security-analysis.ts +0 -192
- package/src/tools/intelligence.ts +0 -331
- package/src/tools/lookalike-analysis.ts +0 -176
- package/src/tools/map-compliance.ts +0 -243
- package/src/tools/map-supply-chain.ts +0 -458
- package/src/tools/mta-sts-analysis.ts +0 -250
- package/src/tools/mx-analysis.ts +0 -55
- package/src/tools/mx-reputation-analysis.ts +0 -205
- package/src/tools/ns-analysis.ts +0 -162
- package/src/tools/provider-guides.ts +0 -404
- package/src/tools/resolve-spf-chain.ts +0 -254
- package/src/tools/scan/format-report.ts +0 -248
- package/src/tools/scan/maturity-staging.ts +0 -166
- package/src/tools/scan/post-processing.ts +0 -270
- package/src/tools/scan-domain.ts +0 -664
- package/src/tools/simulate-attack-paths.ts +0 -513
- package/src/tools/spf-analysis.ts +0 -203
- package/src/tools/spf-trust-surface.ts +0 -138
- package/src/tools/srv-analysis.ts +0 -118
- package/src/tools/ssl-analysis.ts +0 -102
- package/src/tools/subdomain-takeover-analysis.ts +0 -202
- package/src/tools/txt-hygiene-analysis.ts +0 -87
- package/src/tools/validate-fix.ts +0 -219
- package/src/tools/zone-hygiene-analysis.ts +0 -217
- package/src/types/env.d.ts +0 -6
- package/test/.!52131!.DS_Store +0 -0
- package/test/adaptive-weights.spec.ts +0 -359
- package/test/alerting.spec.ts +0 -91
- package/test/analytics-ip-hash.spec.ts +0 -90
- package/test/analytics-queries.spec.ts +0 -197
- package/test/analytics-stream.spec.ts +0 -32
- package/test/analytics.spec.ts +0 -205
- package/test/analyze-drift.spec.ts +0 -82
- package/test/assess-spoofability.spec.ts +0 -186
- package/test/audit.spec.ts +0 -250
- package/test/audits/fuzzing-config.audit.test.ts +0 -76
- package/test/audits/no-tracked-secrets.audit.test.ts +0 -166
- package/test/audits/oauth-readiness-gate.audit.test.ts +0 -83
- package/test/audits/tenant-capacity-readiness.audit.test.ts +0 -92
- package/test/audits/tenant-scale-quota.audit.test.ts +0 -35
- package/test/audits/tool-quota-coverage.audit.test.ts +0 -41
- package/test/audits/workflow-secret-check.audit.test.ts +0 -79
- package/test/auth.spec.ts +0 -94
- package/test/badge.spec.ts +0 -112
- package/test/batch-scan.spec.ts +0 -141
- package/test/caa-analysis.spec.ts +0 -24
- package/test/cache.spec.ts +0 -421
- package/test/category-interactions.spec.ts +0 -172
- package/test/chaos/fuzzing-degradation.chaos.test.ts +0 -50
- package/test/chaos/invariants.spec.ts +0 -181
- package/test/chaos/oauth-misconfiguration.chaos.test.ts +0 -132
- package/test/chaos/tenant-cron.chaos.test.ts +0 -276
- package/test/chaos/tenant-queue.chaos.test.ts +0 -272
- package/test/check-bimi.spec.ts +0 -160
- package/test/check-caa.spec.ts +0 -144
- package/test/check-cymru-asn.spec.ts +0 -239
- package/test/check-dane-https.spec.ts +0 -203
- package/test/check-dane.spec.ts +0 -234
- package/test/check-dbl.spec.ts +0 -214
- package/test/check-dkim.spec.ts +0 -413
- package/test/check-dmarc.spec.ts +0 -377
- package/test/check-dnssec-catch.spec.ts +0 -48
- package/test/check-dnssec-chain.spec.ts +0 -196
- package/test/check-dnssec.spec.ts +0 -271
- package/test/check-fast-flux.spec.ts +0 -201
- package/test/check-http-security.spec.ts +0 -420
- package/test/check-lookalikes.spec.ts +0 -860
- package/test/check-mta-sts.spec.ts +0 -196
- package/test/check-mx-reputation.spec.ts +0 -395
- package/test/check-mx.spec.ts +0 -183
- package/test/check-ns.spec.ts +0 -172
- package/test/check-nsec-walkability.spec.ts +0 -107
- package/test/check-rbl.spec.ts +0 -283
- package/test/check-rdap-lookup.spec.ts +0 -235
- package/test/check-resolver-consistency.spec.ts +0 -117
- package/test/check-shadow-domains.spec.ts +0 -883
- package/test/check-spf.spec.ts +0 -399
- package/test/check-srv.spec.ts +0 -160
- package/test/check-ssl.spec.ts +0 -192
- package/test/check-subdomailing.spec.ts +0 -308
- package/test/check-subdomain-takeover.spec.ts +0 -366
- package/test/check-svcb-https.spec.ts +0 -247
- package/test/check-tlsrpt.spec.ts +0 -70
- package/test/check-txt-hygiene.spec.ts +0 -414
- package/test/check-zone-hygiene.spec.ts +0 -234
- package/test/circuit-breaker.spec.ts +0 -171
- package/test/client-detection.spec.ts +0 -73
- package/test/compare-baseline.spec.ts +0 -221
- package/test/compare-domains.spec.ts +0 -46
- package/test/config.spec.ts +0 -216
- package/test/context-profiles.spec.ts +0 -215
- package/test/contracts/fuzzing-alert.contract.test.ts +0 -58
- package/test/contracts/oauth-tier.contract.test.ts +0 -53
- package/test/contracts/tenant-alerts.contract.test.ts +0 -79
- package/test/dane-analysis.spec.ts +0 -165
- package/test/data/batch_test.json +0 -1
- package/test/data/domains.json +0 -26976
- package/test/data/rescan_batch.json +0 -1
- package/test/data/sync_test.json +0 -1
- package/test/data/temp_sync_batch.json +0 -1
- package/test/discover-brand-domains.spec.ts +0 -215
- package/test/discover-subdomains.spec.ts +0 -382
- package/test/dispatch-reinitialize.spec.ts +0 -101
- package/test/dkim-analysis.spec.ts +0 -48
- package/test/dmarc-utils.spec.ts +0 -27
- package/test/dns-multi-resolver.spec.ts +0 -109
- package/test/dns-records-new.spec.ts +0 -244
- package/test/dns-records.spec.ts +0 -20
- package/test/dns-semaphore.spec.ts +0 -184
- package/test/dns-transport.spec.ts +0 -669
- package/test/dns.spec.ts +0 -118
- package/test/dnssec-analysis.spec.ts +0 -48
- package/test/env.d.ts +0 -3
- package/test/explain-finding.spec.ts +0 -578
- package/test/format-report.spec.ts +0 -273
- package/test/format-scan-report.spec.ts +0 -160
- package/test/freemium-limits.spec.ts +0 -102
- package/test/freemium-model.spec.ts +0 -143
- package/test/fuzzing-alert-dedup.test.ts +0 -82
- package/test/fuzzing-counter.integration.test.ts +0 -75
- package/test/fuzzing-detector.test.ts +0 -87
- package/test/fuzzing-e2e.integration.test.ts +0 -114
- package/test/generate-discovery-report.spec.ts +0 -337
- package/test/generate-fix-plan.spec.ts +0 -219
- package/test/generate-records.spec.ts +0 -241
- package/test/generate-rollout-plan.spec.ts +0 -261
- package/test/handlers-prompts.spec.ts +0 -96
- package/test/handlers-resources.spec.ts +0 -85
- package/test/handlers-tools.spec.ts +0 -1042
- package/test/helpers/dns-mock.ts +0 -155
- package/test/http-security-analysis.spec.ts +0 -242
- package/test/index.spec.ts +0 -1721
- package/test/intelligence.spec.ts +0 -217
- package/test/internal-guard.spec.ts +0 -34
- package/test/internal-tools-analytics-auth.test.ts +0 -102
- package/test/internal-tools-call-body-limit.test.ts +0 -45
- package/test/internal-trial-keys-auth.spec.ts +0 -99
- package/test/internal.spec.ts +0 -411
- package/test/ip-utils.spec.ts +0 -127
- package/test/kv-fallback-logging.spec.ts +0 -220
- package/test/legacy-session-validation.spec.ts +0 -113
- package/test/legacy-sse.spec.ts +0 -140
- package/test/log-cf-ip-redaction.test.ts +0 -30
- package/test/log.spec.ts +0 -189
- package/test/lookalike-analysis.spec.ts +0 -67
- package/test/map-compliance.spec.ts +0 -284
- package/test/map-supply-chain.spec.ts +0 -584
- package/test/maturity-staging.spec.ts +0 -312
- package/test/mcp-dispatch.spec.ts +0 -123
- package/test/mcp-execute.spec.ts +0 -1259
- package/test/mcp-request.spec.ts +0 -115
- package/test/mcp-route-gates.spec.ts +0 -88
- package/test/mta-sts-analysis.spec.ts +0 -74
- package/test/mx-analysis.spec.ts +0 -32
- package/test/mx-reputation-analysis.spec.ts +0 -116
- package/test/ns-analysis.spec.ts +0 -49
- package/test/oauth/authorize-get.spec.ts +0 -170
- package/test/oauth/authorize-post.spec.ts +0 -286
- package/test/oauth/authorize-zod-leak.test.ts +0 -40
- package/test/oauth/bearer-jwt.spec.ts +0 -152
- package/test/oauth/discovery.spec.ts +0 -51
- package/test/oauth/e2e.spec.ts +0 -141
- package/test/oauth/entitlements.spec.ts +0 -110
- package/test/oauth/internal-grant.spec.ts +0 -183
- package/test/oauth/jwt.spec.ts +0 -91
- package/test/oauth/pkce.spec.ts +0 -57
- package/test/oauth/register.spec.ts +0 -79
- package/test/oauth/storage.spec.ts +0 -74
- package/test/oauth/token.spec.ts +0 -270
- package/test/output-sanitize.spec.ts +0 -450
- package/test/package-api.spec.ts +0 -35
- package/test/profile-accumulator.spec.ts +0 -567
- package/test/provider-guides.spec.ts +0 -74
- package/test/provider-signature-source.spec.ts +0 -68
- package/test/provider-signatures.spec.ts +0 -112
- package/test/public-suffix.spec.ts +0 -197
- package/test/queue-consumer-analytics.spec.ts +0 -65
- package/test/quota-coordinator.spec.ts +0 -74
- package/test/rate-limit-chaos.spec.ts +0 -529
- package/test/rate-limiter-kv-reset.test.ts +0 -62
- package/test/rate-limiter-memory.spec.ts +0 -31
- package/test/rate-limiter-ttl.spec.ts +0 -100
- package/test/rate-limiter.spec.ts +0 -491
- package/test/resolve-spf-chain.spec.ts +0 -183
- package/test/safe-fetch.test.ts +0 -45
- package/test/sanitize.spec.ts +0 -233
- package/test/scan-domain-cache-status.test.ts +0 -128
- package/test/scan-domain-provider-inference.spec.ts +0 -93
- package/test/scan-domain-safe-check.spec.ts +0 -91
- package/test/scan-domain.spec.ts +0 -1063
- package/test/scan-post-processing.spec.ts +0 -663
- package/test/scheduled.spec.ts +0 -104
- package/test/schemas/audit.test.ts +0 -140
- package/test/schemas/auth.spec.ts +0 -36
- package/test/schemas/dns.spec.ts +0 -48
- package/test/schemas/internal.spec.ts +0 -50
- package/test/schemas/json-rpc.spec.ts +0 -63
- package/test/schemas/oauth.spec.ts +0 -104
- package/test/schemas/primitives.spec.ts +0 -131
- package/test/schemas/session.spec.ts +0 -21
- package/test/schemas/tenant-alerts.test.ts +0 -126
- package/test/schemas/tenant-internal.test.ts +0 -128
- package/test/schemas/tool-args.spec.ts +0 -166
- package/test/schemas/tool-definitions.spec.ts +0 -67
- package/test/scoring-config-cached.spec.ts +0 -63
- package/test/scoring-config.spec.ts +0 -177
- package/test/scoring-determinism.spec.ts +0 -162
- package/test/scoring-engine.spec.ts +0 -134
- package/test/scoring-model.spec.ts +0 -44
- package/test/scoring-profiles.spec.ts +0 -235
- package/test/scoring.spec.ts +0 -197
- package/test/security-hardening.spec.ts +0 -58
- package/test/session-degradation-event.spec.ts +0 -66
- package/test/session-keepalive.spec.ts +0 -347
- package/test/session-kv-failure-logging.spec.ts +0 -99
- package/test/session-memory.spec.ts +0 -111
- package/test/session-recovery.spec.ts +0 -260
- package/test/session.spec.ts +0 -266
- package/test/simulate-attack-paths.spec.ts +0 -888
- package/test/spf-analysis.spec.ts +0 -29
- package/test/spf-trust-surface.spec.ts +0 -62
- package/test/srv-analysis.spec.ts +0 -151
- package/test/sse.spec.ts +0 -44
- package/test/ssl-analysis.spec.ts +0 -27
- package/test/stdio.spec.ts +0 -71
- package/test/streaming-sse.spec.ts +0 -419
- package/test/subdomain-takeover-analysis.spec.ts +0 -104
- package/test/tenants/alerts/diff.test.ts +0 -127
- package/test/tenants/alerts/webhook.test.ts +0 -129
- package/test/tenants/audit.test.ts +0 -220
- package/test/tenants/cron.integration.test.ts +0 -117
- package/test/tenants/db/registry-schema.spec.ts +0 -254
- package/test/tenants/db/tenant-schema.spec.ts +0 -202
- package/test/tenants/discovery/dkim-key-reuse.test.ts +0 -213
- package/test/tenants/discovery/dmarc-rua-miner.test.ts +0 -179
- package/test/tenants/discovery/ns-correlator.test.ts +0 -186
- package/test/tenants/discovery/san-correlator.test.ts +0 -128
- package/test/tenants/discovery-route.integration.test.ts +0 -135
- package/test/tenants/dns-fingerprint.test.ts +0 -321
- package/test/tenants/hammer-stress.integration.test.ts +0 -136
- package/test/tenants/per-tenant-rate-limit.test.ts +0 -119
- package/test/tenants/phase6-fingerprint.integration.test.ts +0 -147
- package/test/tenants/provision-tenant.test.ts +0 -351
- package/test/tenants/queue-consumer.integration.test.ts +0 -355
- package/test/tenants/queue-producer.integration.test.ts +0 -219
- package/test/tenants/routes.integration.test.ts +0 -783
- package/test/tenants/scheduled-handlers.integration.test.ts +0 -713
- package/test/tenants/tenant-d1.spec.ts +0 -78
- package/test/tenants/tenant-kv.spec.ts +0 -104
- package/test/tenants/tenant-r2.spec.ts +0 -103
- package/test/tier-auth-jwt-enum.test.ts +0 -55
- package/test/tier-auth-owner-jwt-ip.test.ts +0 -80
- package/test/tier-auth.spec.ts +0 -191
- package/test/tool-args.spec.ts +0 -101
- package/test/tool-execution.spec.ts +0 -421
- package/test/tool-formatters.spec.ts +0 -84
- package/test/tool-metadata.spec.ts +0 -25
- package/test/tool-schemas.spec.ts +0 -113
- package/test/trial-keys.spec.ts +0 -367
- package/test/tsconfig.json +0 -8
- package/test/txt-hygiene-analysis.spec.ts +0 -118
- package/test/validate-fix.spec.ts +0 -71
- package/test/validate-outbound-url.test.ts +0 -63
- package/test/wasm-integration.test.ts +0 -32
- package/test/zone-hygiene-analysis.spec.ts +0 -172
- package/tsconfig.json +0 -40
- package/tsup.config.ts +0 -42
- package/vitest.config.mts +0 -33
- package/wrangler.jsonc +0 -70
- package/wrangler.private.example.jsonc +0 -31
package/dist/cli.js
ADDED
|
@@ -0,0 +1,1098 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
import { writeFile, readFile } from 'fs/promises';
|
|
3
|
+
import { z } from 'zod';
|
|
4
|
+
|
|
5
|
+
var EVIDENCE_SCHEMA_VERSION = "blackveil-evidence/v1";
|
|
6
|
+
var EVIDENCE_CANONICALIZATION = "blackveil-cjson/v1";
|
|
7
|
+
var EvidenceSourceSchema = z.object({
|
|
8
|
+
serverName: z.string().min(1),
|
|
9
|
+
serverVersion: z.string().min(1),
|
|
10
|
+
endpointOrigin: z.string().url(),
|
|
11
|
+
tool: z.string().min(1)
|
|
12
|
+
}).strict();
|
|
13
|
+
var EvidenceSnapshotSchema = z.object({
|
|
14
|
+
schemaVersion: z.literal(EVIDENCE_SCHEMA_VERSION),
|
|
15
|
+
capturedAt: z.string().datetime(),
|
|
16
|
+
source: EvidenceSourceSchema,
|
|
17
|
+
result: z.record(z.string(), z.unknown()),
|
|
18
|
+
integrity: z.object({
|
|
19
|
+
algorithm: z.literal("sha-256"),
|
|
20
|
+
canonicalization: z.literal(EVIDENCE_CANONICALIZATION),
|
|
21
|
+
digest: z.string().regex(/^[a-f0-9]{64}$/)
|
|
22
|
+
}).strict()
|
|
23
|
+
}).strict();
|
|
24
|
+
function canonicalize(value, seen) {
|
|
25
|
+
if (value === null) return "null";
|
|
26
|
+
if (typeof value === "string" || typeof value === "boolean") return JSON.stringify(value);
|
|
27
|
+
if (typeof value === "number") {
|
|
28
|
+
if (!Number.isFinite(value)) throw new Error("Evidence contains a non-finite number");
|
|
29
|
+
return JSON.stringify(value);
|
|
30
|
+
}
|
|
31
|
+
if (typeof value !== "object") throw new Error(`Evidence contains an unsupported ${typeof value} value`);
|
|
32
|
+
if (seen.has(value)) throw new Error("Evidence contains a circular reference");
|
|
33
|
+
seen.add(value);
|
|
34
|
+
try {
|
|
35
|
+
if (Array.isArray(value)) {
|
|
36
|
+
return `[${value.map((entry) => canonicalize(entry, seen)).join(",")}]`;
|
|
37
|
+
}
|
|
38
|
+
const record = value;
|
|
39
|
+
const entries = Object.keys(record).sort().map((key) => `${JSON.stringify(key)}:${canonicalize(record[key], seen)}`);
|
|
40
|
+
return `{${entries.join(",")}}`;
|
|
41
|
+
} finally {
|
|
42
|
+
seen.delete(value);
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
function canonicalEvidenceJson(value) {
|
|
46
|
+
return canonicalize(value, /* @__PURE__ */ new Set());
|
|
47
|
+
}
|
|
48
|
+
async function sha256Hex(value) {
|
|
49
|
+
const bytes = new TextEncoder().encode(value);
|
|
50
|
+
const digest = await crypto.subtle.digest("SHA-256", bytes);
|
|
51
|
+
return Array.from(new Uint8Array(digest), (byte) => byte.toString(16).padStart(2, "0")).join("");
|
|
52
|
+
}
|
|
53
|
+
async function digestUnsignedSnapshot(snapshot) {
|
|
54
|
+
return sha256Hex(canonicalEvidenceJson(snapshot));
|
|
55
|
+
}
|
|
56
|
+
async function createEvidenceSnapshot(args) {
|
|
57
|
+
const unsigned = {
|
|
58
|
+
schemaVersion: EVIDENCE_SCHEMA_VERSION,
|
|
59
|
+
capturedAt: args.capturedAt,
|
|
60
|
+
source: {
|
|
61
|
+
serverName: args.serverName,
|
|
62
|
+
serverVersion: args.serverVersion,
|
|
63
|
+
endpointOrigin: args.endpointOrigin,
|
|
64
|
+
tool: args.tool
|
|
65
|
+
},
|
|
66
|
+
result: args.result
|
|
67
|
+
};
|
|
68
|
+
const digest = await digestUnsignedSnapshot(unsigned);
|
|
69
|
+
return {
|
|
70
|
+
...unsigned,
|
|
71
|
+
integrity: {
|
|
72
|
+
algorithm: "sha-256",
|
|
73
|
+
canonicalization: EVIDENCE_CANONICALIZATION,
|
|
74
|
+
digest
|
|
75
|
+
}
|
|
76
|
+
};
|
|
77
|
+
}
|
|
78
|
+
async function verifyEvidenceSnapshot(value) {
|
|
79
|
+
const snapshot = EvidenceSnapshotSchema.parse(value);
|
|
80
|
+
const { integrity, ...unsigned } = snapshot;
|
|
81
|
+
const actualDigest = await digestUnsignedSnapshot(unsigned);
|
|
82
|
+
return {
|
|
83
|
+
valid: actualDigest === integrity.digest,
|
|
84
|
+
snapshot,
|
|
85
|
+
expectedDigest: integrity.digest,
|
|
86
|
+
actualDigest
|
|
87
|
+
};
|
|
88
|
+
}
|
|
89
|
+
var DEFAULT_MCP_ENDPOINT = "https://dns-mcp.blackveilsecurity.com/mcp";
|
|
90
|
+
var REQUESTED_PROTOCOL_VERSION = "2025-06-18";
|
|
91
|
+
var SUPPORTED_PROTOCOL_VERSIONS = /* @__PURE__ */ new Set(["2025-06-18", "2025-03-26"]);
|
|
92
|
+
var MCP_RESPONSE_BODY_MAX_BYTES = 2 * 1024 * 1024;
|
|
93
|
+
var MCP_SSE_EVENT_MAX_BYTES = 512 * 1024;
|
|
94
|
+
var ServerInfoSchema = z.object({ name: z.string().min(1), version: z.string().min(1) }).passthrough();
|
|
95
|
+
var InitializeResultSchema = z.object({ protocolVersion: z.string().min(1), serverInfo: ServerInfoSchema }).passthrough();
|
|
96
|
+
var ToolCallResultSchema = z.object({
|
|
97
|
+
content: z.array(z.object({ type: z.string(), text: z.string().optional() }).passthrough()),
|
|
98
|
+
structuredContent: z.record(z.string(), z.unknown()).optional(),
|
|
99
|
+
isError: z.boolean().optional()
|
|
100
|
+
}).passthrough();
|
|
101
|
+
var ToolListSchema = z.object({
|
|
102
|
+
tools: z.array(
|
|
103
|
+
z.object({
|
|
104
|
+
name: z.string().min(1),
|
|
105
|
+
outputSchema: z.record(z.string(), z.unknown()).optional(),
|
|
106
|
+
annotations: z.object({ readOnlyHint: z.boolean().optional() }).passthrough().optional()
|
|
107
|
+
}).passthrough()
|
|
108
|
+
)
|
|
109
|
+
}).passthrough();
|
|
110
|
+
var McpClientError = class extends Error {
|
|
111
|
+
constructor(message, kind, status, rpcCode) {
|
|
112
|
+
super(message);
|
|
113
|
+
this.kind = kind;
|
|
114
|
+
this.status = status;
|
|
115
|
+
this.rpcCode = rpcCode;
|
|
116
|
+
this.name = "McpClientError";
|
|
117
|
+
}
|
|
118
|
+
kind;
|
|
119
|
+
status;
|
|
120
|
+
rpcCode;
|
|
121
|
+
};
|
|
122
|
+
function requestIdKey(id) {
|
|
123
|
+
return `${typeof id}:${String(id)}`;
|
|
124
|
+
}
|
|
125
|
+
function asJsonRpcMessage(value) {
|
|
126
|
+
if (!value || typeof value !== "object" || Array.isArray(value))
|
|
127
|
+
throw new McpClientError("MCP returned a malformed JSON-RPC message", "protocol");
|
|
128
|
+
const message = value;
|
|
129
|
+
if (message.jsonrpc !== "2.0") throw new McpClientError("MCP returned a message with an invalid jsonrpc version", "protocol");
|
|
130
|
+
return message;
|
|
131
|
+
}
|
|
132
|
+
function isNotification(message) {
|
|
133
|
+
if (typeof message.method !== "string") return false;
|
|
134
|
+
if (Object.hasOwn(message, "id")) throw new McpClientError(`MCP sent unsupported server request ${message.method}`, "protocol");
|
|
135
|
+
return true;
|
|
136
|
+
}
|
|
137
|
+
function isRequestId(id) {
|
|
138
|
+
return typeof id === "string" || typeof id === "number" && Number.isInteger(id);
|
|
139
|
+
}
|
|
140
|
+
function responseId(message) {
|
|
141
|
+
if (!Object.hasOwn(message, "id") || message.id === null) throw new McpClientError("MCP response omitted its JSON-RPC id", "protocol");
|
|
142
|
+
if (!isRequestId(message.id)) throw new McpClientError("MCP response contained an invalid JSON-RPC id", "protocol");
|
|
143
|
+
return message.id;
|
|
144
|
+
}
|
|
145
|
+
function assertExpectedResponseId(id, expectedId, seenIds) {
|
|
146
|
+
const key = requestIdKey(id);
|
|
147
|
+
if (seenIds.has(key)) throw new McpClientError(`MCP returned duplicate JSON-RPC id ${String(id)}`, "protocol");
|
|
148
|
+
seenIds.add(key);
|
|
149
|
+
if (id !== expectedId) {
|
|
150
|
+
throw new McpClientError(`MCP response id ${String(id)} did not match request id ${String(expectedId)}`, "protocol");
|
|
151
|
+
}
|
|
152
|
+
}
|
|
153
|
+
function responsePayload(message) {
|
|
154
|
+
const hasResult = Object.hasOwn(message, "result");
|
|
155
|
+
const hasError = Object.hasOwn(message, "error");
|
|
156
|
+
if (hasResult === hasError) throw new McpClientError("MCP response must contain exactly one of result or error", "protocol");
|
|
157
|
+
if (!hasError) return { result: message.result };
|
|
158
|
+
const parsed = z.object({ code: z.number().int(), message: z.string() }).passthrough().safeParse(message.error);
|
|
159
|
+
if (!parsed.success) throw new McpClientError("MCP returned a malformed JSON-RPC error", "protocol");
|
|
160
|
+
return { error: parsed.data };
|
|
161
|
+
}
|
|
162
|
+
function classifyJsonRpcMessage(value, expectedId, seenIds) {
|
|
163
|
+
const message = asJsonRpcMessage(value);
|
|
164
|
+
if (isNotification(message)) return void 0;
|
|
165
|
+
assertExpectedResponseId(responseId(message), expectedId, seenIds);
|
|
166
|
+
return responsePayload(message);
|
|
167
|
+
}
|
|
168
|
+
function parseSseEvent(event) {
|
|
169
|
+
const data = event.split(/\r?\n/).filter((line) => line.startsWith("data:")).map((line) => line.slice(5).trimStart()).join("\n");
|
|
170
|
+
if (!data || data === "[DONE]") return void 0;
|
|
171
|
+
try {
|
|
172
|
+
return JSON.parse(data);
|
|
173
|
+
} catch {
|
|
174
|
+
throw new McpClientError("MCP response contained invalid SSE JSON", "protocol");
|
|
175
|
+
}
|
|
176
|
+
}
|
|
177
|
+
function drainCompleteSseEvents(buffer) {
|
|
178
|
+
const events = [];
|
|
179
|
+
let remainder = buffer;
|
|
180
|
+
for (; ; ) {
|
|
181
|
+
const separator = /\r?\n\r?\n/.exec(remainder);
|
|
182
|
+
if (!separator || separator.index === void 0) return { events, remainder };
|
|
183
|
+
events.push(remainder.slice(0, separator.index));
|
|
184
|
+
remainder = remainder.slice(separator.index + separator[0].length);
|
|
185
|
+
}
|
|
186
|
+
}
|
|
187
|
+
async function cancelReader(reader) {
|
|
188
|
+
try {
|
|
189
|
+
await reader.cancel();
|
|
190
|
+
} catch {
|
|
191
|
+
} finally {
|
|
192
|
+
try {
|
|
193
|
+
reader.releaseLock();
|
|
194
|
+
} catch {
|
|
195
|
+
}
|
|
196
|
+
}
|
|
197
|
+
}
|
|
198
|
+
async function discardResponseBody(response) {
|
|
199
|
+
if (!response.body) return;
|
|
200
|
+
let reader;
|
|
201
|
+
try {
|
|
202
|
+
reader = response.body.getReader();
|
|
203
|
+
} catch {
|
|
204
|
+
return;
|
|
205
|
+
}
|
|
206
|
+
await cancelReader(reader);
|
|
207
|
+
}
|
|
208
|
+
async function readResponseTextCapped(response) {
|
|
209
|
+
const contentLength = Number(response.headers.get("content-length"));
|
|
210
|
+
if (Number.isFinite(contentLength) && contentLength > MCP_RESPONSE_BODY_MAX_BYTES) {
|
|
211
|
+
await discardResponseBody(response);
|
|
212
|
+
throw new McpClientError("MCP response exceeded the response body limit", "protocol", response.status);
|
|
213
|
+
}
|
|
214
|
+
if (!response.body) return "";
|
|
215
|
+
const reader = response.body.getReader();
|
|
216
|
+
const decoder = new TextDecoder();
|
|
217
|
+
let bytesRead = 0;
|
|
218
|
+
let text = "";
|
|
219
|
+
let complete = false;
|
|
220
|
+
try {
|
|
221
|
+
for (; ; ) {
|
|
222
|
+
const chunk = await reader.read();
|
|
223
|
+
if (chunk.value) {
|
|
224
|
+
bytesRead += chunk.value.byteLength;
|
|
225
|
+
if (bytesRead > MCP_RESPONSE_BODY_MAX_BYTES) {
|
|
226
|
+
throw new McpClientError("MCP response exceeded the response body limit", "protocol", response.status);
|
|
227
|
+
}
|
|
228
|
+
text += decoder.decode(chunk.value, { stream: true });
|
|
229
|
+
}
|
|
230
|
+
if (chunk.done) {
|
|
231
|
+
text += decoder.decode();
|
|
232
|
+
complete = true;
|
|
233
|
+
return text;
|
|
234
|
+
}
|
|
235
|
+
}
|
|
236
|
+
} finally {
|
|
237
|
+
if (!complete) {
|
|
238
|
+
await cancelReader(reader);
|
|
239
|
+
} else {
|
|
240
|
+
try {
|
|
241
|
+
reader.releaseLock();
|
|
242
|
+
} catch {
|
|
243
|
+
}
|
|
244
|
+
}
|
|
245
|
+
}
|
|
246
|
+
}
|
|
247
|
+
function parseMcpResponseBody(text, expectedId) {
|
|
248
|
+
const trimmed = text.trim();
|
|
249
|
+
if (!trimmed) return void 0;
|
|
250
|
+
try {
|
|
251
|
+
const parsed = JSON.parse(trimmed);
|
|
252
|
+
if (expectedId === void 0) return parsed;
|
|
253
|
+
const response = classifyJsonRpcMessage(parsed, expectedId, /* @__PURE__ */ new Set());
|
|
254
|
+
if (!response) throw new McpClientError("MCP response contained notifications but no matching response", "protocol");
|
|
255
|
+
return response;
|
|
256
|
+
} catch (error) {
|
|
257
|
+
if (error instanceof McpClientError) throw error;
|
|
258
|
+
}
|
|
259
|
+
const seen = /* @__PURE__ */ new Set();
|
|
260
|
+
let matched;
|
|
261
|
+
for (const event of text.split(/\r?\n\r?\n/)) {
|
|
262
|
+
const value = parseSseEvent(event);
|
|
263
|
+
if (value === void 0) continue;
|
|
264
|
+
if (expectedId === void 0) return value;
|
|
265
|
+
const response = classifyJsonRpcMessage(value, expectedId, seen);
|
|
266
|
+
if (response) {
|
|
267
|
+
if (matched) throw new McpClientError(`MCP returned duplicate JSON-RPC id ${String(expectedId)}`, "protocol");
|
|
268
|
+
matched = response;
|
|
269
|
+
}
|
|
270
|
+
}
|
|
271
|
+
if (!matched) throw new McpClientError("MCP response contained no matching JSON-RPC response", "protocol");
|
|
272
|
+
return matched;
|
|
273
|
+
}
|
|
274
|
+
async function readMatchingSseResponse(response, expectedId) {
|
|
275
|
+
if (!response.body) throw new McpClientError("MCP SSE response omitted its body", "protocol", response.status);
|
|
276
|
+
const reader = response.body.getReader();
|
|
277
|
+
const decoder = new TextDecoder();
|
|
278
|
+
const seen = /* @__PURE__ */ new Set();
|
|
279
|
+
let buffer = "";
|
|
280
|
+
let bytesRead = 0;
|
|
281
|
+
try {
|
|
282
|
+
for (; ; ) {
|
|
283
|
+
const chunk = await reader.read();
|
|
284
|
+
if (chunk.value) {
|
|
285
|
+
bytesRead += chunk.value.byteLength;
|
|
286
|
+
if (bytesRead > MCP_RESPONSE_BODY_MAX_BYTES) {
|
|
287
|
+
throw new McpClientError("MCP SSE response exceeded the response body limit", "protocol", response.status);
|
|
288
|
+
}
|
|
289
|
+
}
|
|
290
|
+
buffer += decoder.decode(chunk.value, { stream: !chunk.done });
|
|
291
|
+
const drained = drainCompleteSseEvents(buffer);
|
|
292
|
+
buffer = drained.remainder;
|
|
293
|
+
if (new TextEncoder().encode(buffer).byteLength > MCP_SSE_EVENT_MAX_BYTES) {
|
|
294
|
+
throw new McpClientError("MCP SSE event exceeded the event limit", "protocol", response.status);
|
|
295
|
+
}
|
|
296
|
+
if (chunk.done && buffer.trim()) {
|
|
297
|
+
drained.events.push(buffer);
|
|
298
|
+
buffer = "";
|
|
299
|
+
}
|
|
300
|
+
let matched;
|
|
301
|
+
for (const event of drained.events) {
|
|
302
|
+
if (new TextEncoder().encode(event).byteLength > MCP_SSE_EVENT_MAX_BYTES) {
|
|
303
|
+
throw new McpClientError("MCP SSE event exceeded the event limit", "protocol", response.status);
|
|
304
|
+
}
|
|
305
|
+
const value = parseSseEvent(event);
|
|
306
|
+
if (value === void 0) continue;
|
|
307
|
+
const candidate = classifyJsonRpcMessage(value, expectedId, seen);
|
|
308
|
+
if (candidate) {
|
|
309
|
+
if (matched) throw new McpClientError(`MCP returned duplicate JSON-RPC id ${String(expectedId)}`, "protocol");
|
|
310
|
+
matched = candidate;
|
|
311
|
+
}
|
|
312
|
+
}
|
|
313
|
+
if (matched) return matched;
|
|
314
|
+
if (chunk.done) throw new McpClientError("MCP SSE stream ended without a matching JSON-RPC response", "protocol");
|
|
315
|
+
}
|
|
316
|
+
} finally {
|
|
317
|
+
await cancelReader(reader);
|
|
318
|
+
}
|
|
319
|
+
}
|
|
320
|
+
function validateEndpoint(endpoint) {
|
|
321
|
+
let url;
|
|
322
|
+
try {
|
|
323
|
+
url = new URL(endpoint);
|
|
324
|
+
} catch {
|
|
325
|
+
throw new McpClientError("Invalid BLACKVEIL_MCP_URL", "protocol");
|
|
326
|
+
}
|
|
327
|
+
if (url.username || url.password || url.search || url.hash) {
|
|
328
|
+
throw new McpClientError("Invalid BLACKVEIL_MCP_URL: credentials, query strings, and fragments are not allowed", "protocol");
|
|
329
|
+
}
|
|
330
|
+
const loopback = url.hostname === "localhost" || url.hostname === "127.0.0.1" || url.hostname === "[::1]";
|
|
331
|
+
if (url.protocol !== "https:" && !(url.protocol === "http:" && loopback)) {
|
|
332
|
+
throw new McpClientError("Invalid BLACKVEIL_MCP_URL: HTTPS is required except on loopback", "protocol");
|
|
333
|
+
}
|
|
334
|
+
return url;
|
|
335
|
+
}
|
|
336
|
+
var McpHttpClient = class {
|
|
337
|
+
endpoint;
|
|
338
|
+
endpointOrigin;
|
|
339
|
+
serverInfo;
|
|
340
|
+
fetchFn;
|
|
341
|
+
apiKey;
|
|
342
|
+
signalFactory;
|
|
343
|
+
now;
|
|
344
|
+
deadlineAt;
|
|
345
|
+
sessionId;
|
|
346
|
+
protocolVersion = REQUESTED_PROTOCOL_VERSION;
|
|
347
|
+
initialized = false;
|
|
348
|
+
sessionRecoveryUsed = false;
|
|
349
|
+
requestId = 1;
|
|
350
|
+
constructor(options = {}) {
|
|
351
|
+
const endpoint = validateEndpoint(options.endpoint ?? DEFAULT_MCP_ENDPOINT);
|
|
352
|
+
this.endpoint = endpoint.toString();
|
|
353
|
+
this.endpointOrigin = endpoint.origin;
|
|
354
|
+
this.fetchFn = options.fetchFn ?? fetch;
|
|
355
|
+
this.apiKey = options.apiKey;
|
|
356
|
+
this.now = options.now ?? Date.now;
|
|
357
|
+
this.deadlineAt = options.deadlineAt ?? this.now() + (options.timeoutMs ?? 45e3);
|
|
358
|
+
this.signalFactory = options.signalFactory ?? ((remainingMs) => AbortSignal.timeout(Math.max(1, Math.ceil(remainingMs))));
|
|
359
|
+
}
|
|
360
|
+
headers(includeSession) {
|
|
361
|
+
const headers = new Headers({ accept: "application/json, text/event-stream", "content-type": "application/json" });
|
|
362
|
+
if (includeSession) headers.set("mcp-protocol-version", this.protocolVersion);
|
|
363
|
+
if (includeSession && this.sessionId) headers.set("mcp-session-id", this.sessionId);
|
|
364
|
+
if (this.apiKey) headers.set("authorization", `Bearer ${this.apiKey}`);
|
|
365
|
+
return headers;
|
|
366
|
+
}
|
|
367
|
+
remainingSignal() {
|
|
368
|
+
const remainingMs = this.deadlineAt - this.now();
|
|
369
|
+
if (remainingMs <= 0) throw new McpClientError("MCP command deadline exceeded", "transport");
|
|
370
|
+
return this.signalFactory(remainingMs);
|
|
371
|
+
}
|
|
372
|
+
async request(body, includeSession, expectPayload) {
|
|
373
|
+
let response;
|
|
374
|
+
try {
|
|
375
|
+
response = await this.fetchFn(this.endpoint, {
|
|
376
|
+
method: "POST",
|
|
377
|
+
headers: this.headers(includeSession),
|
|
378
|
+
body: JSON.stringify(body),
|
|
379
|
+
signal: this.remainingSignal()
|
|
380
|
+
});
|
|
381
|
+
} catch (error) {
|
|
382
|
+
if (error instanceof McpClientError) throw error;
|
|
383
|
+
const message = error instanceof Error ? error.message : "request failed";
|
|
384
|
+
throw new McpClientError(`MCP transport failed: ${message}`, "transport");
|
|
385
|
+
}
|
|
386
|
+
if (response.ok && !expectPayload) {
|
|
387
|
+
await discardResponseBody(response);
|
|
388
|
+
return { result: void 0, headers: response.headers };
|
|
389
|
+
}
|
|
390
|
+
const expectedId = body.id;
|
|
391
|
+
if (expectPayload && typeof expectedId !== "string" && (typeof expectedId !== "number" || !Number.isInteger(expectedId))) {
|
|
392
|
+
throw new McpClientError("MCP client request omitted a valid JSON-RPC id", "protocol");
|
|
393
|
+
}
|
|
394
|
+
if (!response.ok) {
|
|
395
|
+
const text = await readResponseTextCapped(response);
|
|
396
|
+
let remote;
|
|
397
|
+
if (text.trim() && expectedId !== void 0) {
|
|
398
|
+
try {
|
|
399
|
+
remote = parseMcpResponseBody(text, expectedId);
|
|
400
|
+
} catch {
|
|
401
|
+
remote = void 0;
|
|
402
|
+
}
|
|
403
|
+
}
|
|
404
|
+
throw new McpClientError(
|
|
405
|
+
remote?.error ? `MCP error ${remote.error.code}: ${remote.error.message}` : `MCP returned HTTP ${response.status}`,
|
|
406
|
+
"remote",
|
|
407
|
+
response.status,
|
|
408
|
+
remote?.error?.code
|
|
409
|
+
);
|
|
410
|
+
}
|
|
411
|
+
const contentType = response.headers.get("content-type")?.toLowerCase() ?? "";
|
|
412
|
+
const parsed = contentType.includes("text/event-stream") ? await readMatchingSseResponse(response, expectedId) : parseMcpResponseBody(await readResponseTextCapped(response), expectedId);
|
|
413
|
+
if (!parsed) throw new McpClientError("MCP response contained no matching JSON-RPC response", "protocol", response.status);
|
|
414
|
+
if (parsed.error) {
|
|
415
|
+
throw new McpClientError(`MCP error ${parsed.error.code}: ${parsed.error.message}`, "remote", response.status, parsed.error.code);
|
|
416
|
+
}
|
|
417
|
+
return { result: parsed.result, headers: response.headers };
|
|
418
|
+
}
|
|
419
|
+
async connect() {
|
|
420
|
+
this.initialized = false;
|
|
421
|
+
this.sessionId = void 0;
|
|
422
|
+
this.serverInfo = void 0;
|
|
423
|
+
this.protocolVersion = REQUESTED_PROTOCOL_VERSION;
|
|
424
|
+
const initialized = await this.request(
|
|
425
|
+
{
|
|
426
|
+
jsonrpc: "2.0",
|
|
427
|
+
id: this.requestId++,
|
|
428
|
+
method: "initialize",
|
|
429
|
+
params: {
|
|
430
|
+
protocolVersion: REQUESTED_PROTOCOL_VERSION,
|
|
431
|
+
capabilities: {},
|
|
432
|
+
clientInfo: { name: "blackveil-cli", version: "1.0.0" }
|
|
433
|
+
}
|
|
434
|
+
},
|
|
435
|
+
false,
|
|
436
|
+
true
|
|
437
|
+
);
|
|
438
|
+
const result = InitializeResultSchema.safeParse(initialized.result);
|
|
439
|
+
if (!result.success) throw new McpClientError("MCP initialize omitted valid protocolVersion or serverInfo", "protocol");
|
|
440
|
+
if (!SUPPORTED_PROTOCOL_VERSIONS.has(result.data.protocolVersion)) {
|
|
441
|
+
throw new McpClientError(`MCP negotiated unsupported protocol version ${result.data.protocolVersion}`, "protocol");
|
|
442
|
+
}
|
|
443
|
+
this.protocolVersion = result.data.protocolVersion;
|
|
444
|
+
this.serverInfo = result.data.serverInfo;
|
|
445
|
+
const sessionId = initialized.headers.get("mcp-session-id");
|
|
446
|
+
if (sessionId) {
|
|
447
|
+
if (!/^[\x21-\x7e]+$/.test(sessionId)) throw new McpClientError("MCP initialize returned an invalid session id", "protocol");
|
|
448
|
+
this.sessionId = sessionId;
|
|
449
|
+
}
|
|
450
|
+
await this.request({ jsonrpc: "2.0", method: "notifications/initialized" }, true, false);
|
|
451
|
+
this.initialized = true;
|
|
452
|
+
return this.serverInfo;
|
|
453
|
+
}
|
|
454
|
+
requireConnected() {
|
|
455
|
+
if (!this.initialized || !this.serverInfo) throw new McpClientError("MCP client is not initialized", "protocol");
|
|
456
|
+
}
|
|
457
|
+
async readOnlyRequest(factory) {
|
|
458
|
+
const hadSession = this.sessionId !== void 0;
|
|
459
|
+
try {
|
|
460
|
+
return await factory();
|
|
461
|
+
} catch (error) {
|
|
462
|
+
if (!(error instanceof McpClientError) || error.status !== 404 || !hadSession || this.sessionRecoveryUsed) throw error;
|
|
463
|
+
this.sessionRecoveryUsed = true;
|
|
464
|
+
await this.connect();
|
|
465
|
+
return factory();
|
|
466
|
+
}
|
|
467
|
+
}
|
|
468
|
+
async listTools() {
|
|
469
|
+
this.requireConnected();
|
|
470
|
+
const response = await this.readOnlyRequest(
|
|
471
|
+
() => this.request({ jsonrpc: "2.0", id: this.requestId++, method: "tools/list", params: {} }, true, true)
|
|
472
|
+
);
|
|
473
|
+
const parsed = ToolListSchema.safeParse(response.result);
|
|
474
|
+
if (!parsed.success) throw new McpClientError("MCP tools/list returned a malformed tool list", "protocol");
|
|
475
|
+
return parsed.data.tools;
|
|
476
|
+
}
|
|
477
|
+
async callTool(name, args, options = {}) {
|
|
478
|
+
this.requireConnected();
|
|
479
|
+
const call = () => this.request(
|
|
480
|
+
{
|
|
481
|
+
jsonrpc: "2.0",
|
|
482
|
+
id: this.requestId++,
|
|
483
|
+
method: "tools/call",
|
|
484
|
+
params: { name, arguments: args }
|
|
485
|
+
},
|
|
486
|
+
true,
|
|
487
|
+
true
|
|
488
|
+
);
|
|
489
|
+
const response = options.readOnly ? await this.readOnlyRequest(call) : await call();
|
|
490
|
+
const parsed = ToolCallResultSchema.safeParse(response.result);
|
|
491
|
+
if (!parsed.success) throw new McpClientError(`MCP tool ${name} returned a malformed result`, "protocol");
|
|
492
|
+
return parsed.data;
|
|
493
|
+
}
|
|
494
|
+
};
|
|
495
|
+
var FindingSchema = z.object({
|
|
496
|
+
category: z.string(),
|
|
497
|
+
title: z.string(),
|
|
498
|
+
severity: z.enum(["critical", "high", "medium", "low", "info"]),
|
|
499
|
+
detail: z.string()
|
|
500
|
+
}).passthrough();
|
|
501
|
+
var EvidenceCoverageSchema = z.object({
|
|
502
|
+
attempted: z.number().int().nonnegative(),
|
|
503
|
+
completed: z.number().int().nonnegative(),
|
|
504
|
+
ratio: z.number().min(0).max(1)
|
|
505
|
+
}).passthrough();
|
|
506
|
+
var ScanResultSchema = z.object({
|
|
507
|
+
domain: z.string().min(1),
|
|
508
|
+
score: z.number().min(0).max(100).nullable(),
|
|
509
|
+
grade: z.string().min(1).nullable(),
|
|
510
|
+
passed: z.boolean().nullable(),
|
|
511
|
+
measured: z.boolean(),
|
|
512
|
+
categoryScores: z.record(z.string(), z.number().nullable()),
|
|
513
|
+
findings: z.array(FindingSchema),
|
|
514
|
+
checkStatuses: z.record(z.string(), z.enum(["completed", "timeout", "error"])),
|
|
515
|
+
notApplicableCategories: z.array(z.string()),
|
|
516
|
+
inconclusiveCategories: z.array(z.string()),
|
|
517
|
+
evidence: EvidenceCoverageSchema,
|
|
518
|
+
evidenceInsufficient: z.boolean(),
|
|
519
|
+
timestamp: z.string().datetime(),
|
|
520
|
+
scoringModelVersion: z.string().min(1),
|
|
521
|
+
dnsChecksPackageVersion: z.string().min(1),
|
|
522
|
+
scoringConfigHash: z.string().min(1),
|
|
523
|
+
error: z.string().optional()
|
|
524
|
+
}).passthrough();
|
|
525
|
+
var CheckResultSchema = z.object({
|
|
526
|
+
category: z.string().min(1),
|
|
527
|
+
passed: z.boolean(),
|
|
528
|
+
score: z.number().min(0).max(100),
|
|
529
|
+
findings: z.array(FindingSchema),
|
|
530
|
+
checkStatus: z.enum(["completed", "timeout", "error"]).optional(),
|
|
531
|
+
partial: z.boolean().optional()
|
|
532
|
+
}).passthrough();
|
|
533
|
+
var NonCompletedCheckStatusSchema = z.enum(["timeout", "error"]);
|
|
534
|
+
function hasIncompleteCheckEvidence(result) {
|
|
535
|
+
return result.partial === true || NonCompletedCheckStatusSchema.safeParse(result.checkStatus).success;
|
|
536
|
+
}
|
|
537
|
+
function hasIncompleteScanEvidence(result) {
|
|
538
|
+
return result.inconclusiveCategories.length > 0 || Object.values(result.checkStatuses).some((status) => NonCompletedCheckStatusSchema.safeParse(status).success);
|
|
539
|
+
}
|
|
540
|
+
var BatchResultSchema = z.object({
|
|
541
|
+
results: z.array(ScanResultSchema).min(1).max(10)
|
|
542
|
+
}).passthrough();
|
|
543
|
+
var PolicyResultSchema = z.object({
|
|
544
|
+
domain: z.string().min(1),
|
|
545
|
+
passed: z.boolean().nullable(),
|
|
546
|
+
violations: z.array(z.unknown()),
|
|
547
|
+
inconclusiveRules: z.array(z.string()),
|
|
548
|
+
checkedRules: z.number().int().nonnegative(),
|
|
549
|
+
timestamp: z.string().datetime()
|
|
550
|
+
}).passthrough();
|
|
551
|
+
var DriftResultSchema = z.object({
|
|
552
|
+
domain: z.string().min(1),
|
|
553
|
+
classification: z.enum(["improving", "stable", "regressing", "mixed", "inconclusive"]),
|
|
554
|
+
scoreDelta: z.number().nullable(),
|
|
555
|
+
gradeChange: z.object({ from: z.string().nullable(), to: z.string().nullable() }).passthrough(),
|
|
556
|
+
timestamp: z.string().datetime()
|
|
557
|
+
}).passthrough();
|
|
558
|
+
|
|
559
|
+
// src/cli/command.ts
|
|
560
|
+
var CliUsageError = class extends Error {
|
|
561
|
+
};
|
|
562
|
+
var CliVerificationError = class extends Error {
|
|
563
|
+
};
|
|
564
|
+
var HELP = `BlackVeil hosted DNS security CLI
|
|
565
|
+
|
|
566
|
+
Usage:
|
|
567
|
+
blackveil scan <domain> [--format human|json|ndjson|evidence] [--out <file>] [--force-refresh]
|
|
568
|
+
[--fail-below <0-100> | --policy <file>]
|
|
569
|
+
blackveil check <name> <domain> [--format human|json|ndjson|evidence] [--out <file>] [--force-refresh]
|
|
570
|
+
blackveil batch --file <domains.txt> [--format human|json|ndjson|evidence] [--out <file>] [--force-refresh]
|
|
571
|
+
[--fail-below <0-100> | --policy <file>]
|
|
572
|
+
blackveil policy <domain> (--fail-below <0-100> | --policy <file>) [--format human|json|ndjson|evidence]
|
|
573
|
+
blackveil drift save <domain> --out <file> [--force-refresh] [--force]
|
|
574
|
+
blackveil drift compare <domain> --baseline <evidence.json> [--format human|json|ndjson|evidence]
|
|
575
|
+
blackveil evidence verify <evidence.json> [--format human|json]
|
|
576
|
+
|
|
577
|
+
Environment:
|
|
578
|
+
BLACKVEIL_API_KEY Optional bearer credential. API keys are never accepted on the command line.
|
|
579
|
+
BLACKVEIL_MCP_URL Optional MCP endpoint. HTTPS is required except for loopback development.
|
|
580
|
+
|
|
581
|
+
Exit codes:
|
|
582
|
+
0 completed/pass; 1 verified policy or integrity failure; 2 usage/input;
|
|
583
|
+
3 auth/quota/transport/protocol/tool error; 4 ungraded/inconclusive/incomplete.
|
|
584
|
+
`;
|
|
585
|
+
var VALUE_OPTIONS = /* @__PURE__ */ new Set(["--format", "--out", "--file", "--policy", "--fail-below", "--baseline"]);
|
|
586
|
+
var BOOLEAN_OPTIONS = /* @__PURE__ */ new Set(["--force-refresh", "--force"]);
|
|
587
|
+
function parseArgs(args) {
|
|
588
|
+
const parsed = { positionals: [], values: /* @__PURE__ */ new Map(), flags: /* @__PURE__ */ new Set() };
|
|
589
|
+
for (let index = 0; index < args.length; index += 1) {
|
|
590
|
+
const token = args[index];
|
|
591
|
+
if (!token) continue;
|
|
592
|
+
if (VALUE_OPTIONS.has(token)) {
|
|
593
|
+
if (parsed.values.has(token)) throw new CliUsageError(`Duplicate option ${token}`);
|
|
594
|
+
const value = args[++index];
|
|
595
|
+
if (!value || value.startsWith("--")) throw new CliUsageError(`Missing value for ${token}`);
|
|
596
|
+
parsed.values.set(token, value);
|
|
597
|
+
continue;
|
|
598
|
+
}
|
|
599
|
+
if (BOOLEAN_OPTIONS.has(token)) {
|
|
600
|
+
if (parsed.flags.has(token)) throw new CliUsageError(`Duplicate option ${token}`);
|
|
601
|
+
parsed.flags.add(token);
|
|
602
|
+
continue;
|
|
603
|
+
}
|
|
604
|
+
if (token.startsWith("-")) throw new CliUsageError(`Unknown option ${token}`);
|
|
605
|
+
parsed.positionals.push(token);
|
|
606
|
+
}
|
|
607
|
+
return parsed;
|
|
608
|
+
}
|
|
609
|
+
function assertOptions(parsed, allowedValues, allowedFlags) {
|
|
610
|
+
for (const option of parsed.values.keys()) {
|
|
611
|
+
if (!allowedValues.includes(option)) throw new CliUsageError(`Option ${option} is not valid for this command`);
|
|
612
|
+
}
|
|
613
|
+
for (const option of parsed.flags) {
|
|
614
|
+
if (!allowedFlags.includes(option)) throw new CliUsageError(`Option ${option} is not valid for this command`);
|
|
615
|
+
}
|
|
616
|
+
}
|
|
617
|
+
function outputFormat(parsed, allowed = ["human", "json", "ndjson", "evidence"]) {
|
|
618
|
+
const value = parsed.values.get("--format") ?? "human";
|
|
619
|
+
if (!allowed.includes(value)) throw new CliUsageError(`Invalid output format ${value}`);
|
|
620
|
+
return value;
|
|
621
|
+
}
|
|
622
|
+
function requiredSinglePosition(parsed, label) {
|
|
623
|
+
if (parsed.positionals.length !== 1 || !parsed.positionals[0]) throw new CliUsageError(`Expected exactly one ${label}`);
|
|
624
|
+
return parsed.positionals[0];
|
|
625
|
+
}
|
|
626
|
+
function parseScoreFloor(raw) {
|
|
627
|
+
const value = Number(raw);
|
|
628
|
+
if (!Number.isFinite(value) || value < 0 || value > 100) throw new CliUsageError("--fail-below must be a number from 0 to 100");
|
|
629
|
+
return value;
|
|
630
|
+
}
|
|
631
|
+
async function parseJsonFile(io, path) {
|
|
632
|
+
let text;
|
|
633
|
+
try {
|
|
634
|
+
text = await io.readTextFile(path);
|
|
635
|
+
} catch (error) {
|
|
636
|
+
const message = error instanceof Error ? error.message : "read failed";
|
|
637
|
+
throw new CliUsageError(`Could not read ${path}: ${message}`);
|
|
638
|
+
}
|
|
639
|
+
try {
|
|
640
|
+
return JSON.parse(text);
|
|
641
|
+
} catch {
|
|
642
|
+
throw new CliUsageError(`${path} does not contain valid JSON`);
|
|
643
|
+
}
|
|
644
|
+
}
|
|
645
|
+
async function loadPolicy(parsed, io) {
|
|
646
|
+
const policyPath = parsed.values.get("--policy");
|
|
647
|
+
const floor = parsed.values.get("--fail-below");
|
|
648
|
+
if (policyPath && floor) throw new CliUsageError("Use either --policy or --fail-below, not both");
|
|
649
|
+
if (floor !== void 0) return { score: parseScoreFloor(floor) };
|
|
650
|
+
if (!policyPath) return void 0;
|
|
651
|
+
const value = await parseJsonFile(io, policyPath);
|
|
652
|
+
if (!value || typeof value !== "object" || Array.isArray(value)) throw new CliUsageError("Policy JSON must be an object");
|
|
653
|
+
return value;
|
|
654
|
+
}
|
|
655
|
+
function requireStructured(result, tool) {
|
|
656
|
+
if (!result.structuredContent) throw new McpClientError(`MCP tool ${tool} omitted structuredContent`, "protocol");
|
|
657
|
+
return result.structuredContent;
|
|
658
|
+
}
|
|
659
|
+
function toolText(result) {
|
|
660
|
+
const text = result.content.find((item) => item.type === "text" && typeof item.text === "string")?.text;
|
|
661
|
+
if (!text) throw new McpClientError("MCP tool result omitted human-readable text", "protocol");
|
|
662
|
+
return text;
|
|
663
|
+
}
|
|
664
|
+
function toolErrorText(result) {
|
|
665
|
+
return result.content.filter((item) => item.type === "text" && typeof item.text === "string").map((item) => item.text).join("\n");
|
|
666
|
+
}
|
|
667
|
+
function sanitizeDiagnostic(value) {
|
|
668
|
+
const withoutTerminalSequences = [];
|
|
669
|
+
for (let index = 0; index < value.length; index += 1) {
|
|
670
|
+
const code = value.charCodeAt(index);
|
|
671
|
+
if (code !== 27) {
|
|
672
|
+
withoutTerminalSequences.push(value[index] ?? "");
|
|
673
|
+
continue;
|
|
674
|
+
}
|
|
675
|
+
const marker = value.charCodeAt(index + 1);
|
|
676
|
+
if (marker === 91) {
|
|
677
|
+
index += 2;
|
|
678
|
+
while (index < value.length && (value.charCodeAt(index) < 64 || value.charCodeAt(index) > 126)) index += 1;
|
|
679
|
+
continue;
|
|
680
|
+
}
|
|
681
|
+
if (marker === 93) {
|
|
682
|
+
index += 2;
|
|
683
|
+
while (index < value.length) {
|
|
684
|
+
const current = value.charCodeAt(index);
|
|
685
|
+
if (current === 7 || current === 27 && value.charCodeAt(index + 1) === 92) break;
|
|
686
|
+
index += 1;
|
|
687
|
+
}
|
|
688
|
+
if (value.charCodeAt(index) === 27) index += 1;
|
|
689
|
+
continue;
|
|
690
|
+
}
|
|
691
|
+
index += 1;
|
|
692
|
+
}
|
|
693
|
+
let sanitized = "";
|
|
694
|
+
for (const character of withoutTerminalSequences.join("").normalize("NFKC")) {
|
|
695
|
+
const code = character.codePointAt(0) ?? 0;
|
|
696
|
+
const unsafeFormatting = code === 8203 || code === 8204 || code === 8205 || code === 65279 || code >= 8234 && code <= 8238 || code >= 8294 && code <= 8297;
|
|
697
|
+
if (!unsafeFormatting && (character === "\n" || character === " " || code >= 32 && !(code >= 127 && code <= 159)))
|
|
698
|
+
sanitized += character;
|
|
699
|
+
}
|
|
700
|
+
return sanitized.replaceAll("\r", "").trim().slice(0, 2e3);
|
|
701
|
+
}
|
|
702
|
+
function classifyToolError(result, io, tool) {
|
|
703
|
+
if (!result.isError) return void 0;
|
|
704
|
+
const message = sanitizeDiagnostic(toolErrorText(result)) || "Remote tool returned an unspecified error";
|
|
705
|
+
io.stderr(`${tool}: ${message}
|
|
706
|
+
`);
|
|
707
|
+
if (/Invalid baseline|could not read|valid JSON/i.test(message)) return 2;
|
|
708
|
+
if (/never graded|could not be scored|nothing to measure/i.test(message)) return 4;
|
|
709
|
+
return 3;
|
|
710
|
+
}
|
|
711
|
+
function scanExit(scan) {
|
|
712
|
+
return !scan.measured || scan.score === null || scan.grade === null || scan.evidenceInsufficient || scan.error || hasIncompleteScanEvidence(scan) ? 4 : 0;
|
|
713
|
+
}
|
|
714
|
+
function policyExit(value) {
|
|
715
|
+
return value.passed === null ? 4 : value.passed ? 0 : 1;
|
|
716
|
+
}
|
|
717
|
+
function combineBatchExitCodes(codes) {
|
|
718
|
+
if (codes.includes(3)) return 3;
|
|
719
|
+
if (codes.includes(4)) return 4;
|
|
720
|
+
if (codes.includes(1)) return 1;
|
|
721
|
+
if (codes.includes(2)) return 2;
|
|
722
|
+
return 0;
|
|
723
|
+
}
|
|
724
|
+
function ndjson(value) {
|
|
725
|
+
const results = value.results;
|
|
726
|
+
if (Array.isArray(results)) return results.map((entry) => JSON.stringify(entry)).join("\n");
|
|
727
|
+
return JSON.stringify(value);
|
|
728
|
+
}
|
|
729
|
+
async function renderedOutput(args) {
|
|
730
|
+
if (args.format === "human") return toolText(args.result);
|
|
731
|
+
const structured = requireStructured(args.result, args.tool);
|
|
732
|
+
if (args.format === "json") return JSON.stringify(structured, null, 2);
|
|
733
|
+
if (args.format === "ndjson") return ndjson(structured);
|
|
734
|
+
const serverInfo = args.client.serverInfo;
|
|
735
|
+
if (!serverInfo) throw new McpClientError("MCP client has no server provenance", "protocol");
|
|
736
|
+
const evidence = await createEvidenceSnapshot({
|
|
737
|
+
capturedAt: args.now().toISOString(),
|
|
738
|
+
serverName: serverInfo.name,
|
|
739
|
+
serverVersion: serverInfo.version,
|
|
740
|
+
endpointOrigin: args.client.endpointOrigin,
|
|
741
|
+
tool: args.tool,
|
|
742
|
+
result: structured
|
|
743
|
+
});
|
|
744
|
+
return JSON.stringify(evidence, null, 2);
|
|
745
|
+
}
|
|
746
|
+
async function emit(io, parsed, content) {
|
|
747
|
+
const out = parsed.values.get("--out");
|
|
748
|
+
if (!out) {
|
|
749
|
+
io.stdout(`${content}
|
|
750
|
+
`);
|
|
751
|
+
return;
|
|
752
|
+
}
|
|
753
|
+
try {
|
|
754
|
+
await io.writeTextFile(out, `${content}
|
|
755
|
+
`, parsed.flags.has("--force"));
|
|
756
|
+
} catch (error) {
|
|
757
|
+
const message = error instanceof Error ? error.message : "write failed";
|
|
758
|
+
throw new CliUsageError(`Could not write ${out}: ${message}`);
|
|
759
|
+
}
|
|
760
|
+
io.stderr(`Wrote ${out}
|
|
761
|
+
`);
|
|
762
|
+
}
|
|
763
|
+
function createClient(deps) {
|
|
764
|
+
const now = deps.nowMs ?? Date.now;
|
|
765
|
+
return new McpHttpClient({
|
|
766
|
+
endpoint: deps.env?.BLACKVEIL_MCP_URL ?? DEFAULT_MCP_ENDPOINT,
|
|
767
|
+
apiKey: deps.env?.BLACKVEIL_API_KEY,
|
|
768
|
+
fetchFn: deps.fetchFn,
|
|
769
|
+
deadlineAt: deps.deadlineAt,
|
|
770
|
+
now
|
|
771
|
+
});
|
|
772
|
+
}
|
|
773
|
+
async function connectedClient(deps) {
|
|
774
|
+
const client = createClient(deps);
|
|
775
|
+
await client.connect();
|
|
776
|
+
return client;
|
|
777
|
+
}
|
|
778
|
+
async function callPolicy(client, domain, baseline, io) {
|
|
779
|
+
const result = await client.callTool("compare_baseline", { domain, baseline, format: "full" }, { readOnly: true });
|
|
780
|
+
const errorExit = classifyToolError(result, io, "compare_baseline");
|
|
781
|
+
if (errorExit !== void 0) return { result, exit: errorExit };
|
|
782
|
+
const parsed = PolicyResultSchema.safeParse(requireStructured(result, "compare_baseline"));
|
|
783
|
+
if (!parsed.success) throw new McpClientError("compare_baseline returned malformed structuredContent", "protocol");
|
|
784
|
+
return { result, exit: policyExit(parsed.data) };
|
|
785
|
+
}
|
|
786
|
+
async function runScan(parsed, deps) {
|
|
787
|
+
assertOptions(parsed, ["--format", "--out", "--policy", "--fail-below"], ["--force-refresh", "--force"]);
|
|
788
|
+
const domain = requiredSinglePosition(parsed, "domain");
|
|
789
|
+
const format = outputFormat(parsed);
|
|
790
|
+
const baseline = await loadPolicy(parsed, deps.io);
|
|
791
|
+
const client = await connectedClient(deps);
|
|
792
|
+
const result = await client.callTool(
|
|
793
|
+
"scan_domain",
|
|
794
|
+
{
|
|
795
|
+
domain,
|
|
796
|
+
format: "full",
|
|
797
|
+
...parsed.flags.has("--force-refresh") ? { force_refresh: true } : {}
|
|
798
|
+
},
|
|
799
|
+
{ readOnly: true }
|
|
800
|
+
);
|
|
801
|
+
const errorExit = classifyToolError(result, deps.io, "scan_domain");
|
|
802
|
+
if (errorExit !== void 0) return errorExit;
|
|
803
|
+
const structured = ScanResultSchema.safeParse(requireStructured(result, "scan_domain"));
|
|
804
|
+
if (!structured.success) throw new McpClientError("scan_domain returned malformed structuredContent", "protocol");
|
|
805
|
+
await emit(deps.io, parsed, await renderedOutput({ result, format, tool: "scan_domain", client, now: deps.now ?? (() => /* @__PURE__ */ new Date()) }));
|
|
806
|
+
const scanCode = scanExit(structured.data);
|
|
807
|
+
if (scanCode !== 0 || !baseline) return scanCode;
|
|
808
|
+
return (await callPolicy(client, domain, baseline, deps.io)).exit;
|
|
809
|
+
}
|
|
810
|
+
async function runCheck(parsed, deps) {
|
|
811
|
+
assertOptions(parsed, ["--format", "--out"], ["--force-refresh", "--force"]);
|
|
812
|
+
if (parsed.positionals.length !== 2) throw new CliUsageError("Expected a check name and one domain");
|
|
813
|
+
const [rawName, domain] = parsed.positionals;
|
|
814
|
+
if (!rawName || !domain) throw new CliUsageError("Expected a check name and one domain");
|
|
815
|
+
const toolName = rawName.startsWith("check_") ? rawName : `check_${rawName.replaceAll("-", "_")}`;
|
|
816
|
+
if (!/^check_[a-z0-9_]+$/.test(toolName)) throw new CliUsageError("Invalid check name");
|
|
817
|
+
const format = outputFormat(parsed);
|
|
818
|
+
const client = await connectedClient(deps);
|
|
819
|
+
const tools = await client.listTools();
|
|
820
|
+
const tool = tools.find((entry) => entry.name === toolName);
|
|
821
|
+
if (!tool || tool.annotations?.readOnlyHint !== true || tool.outputSchema === void 0) {
|
|
822
|
+
throw new CliUsageError(`${toolName} is not a public read-only CheckResult tool`);
|
|
823
|
+
}
|
|
824
|
+
const result = await client.callTool(
|
|
825
|
+
toolName,
|
|
826
|
+
{
|
|
827
|
+
domain,
|
|
828
|
+
format: "full",
|
|
829
|
+
...parsed.flags.has("--force-refresh") ? { force_refresh: true } : {}
|
|
830
|
+
},
|
|
831
|
+
{ readOnly: true }
|
|
832
|
+
);
|
|
833
|
+
const errorExit = classifyToolError(result, deps.io, toolName);
|
|
834
|
+
if (errorExit !== void 0) return errorExit;
|
|
835
|
+
const structured = CheckResultSchema.safeParse(requireStructured(result, toolName));
|
|
836
|
+
if (!structured.success) throw new McpClientError(`${toolName} returned malformed CheckResult structuredContent`, "protocol");
|
|
837
|
+
await emit(deps.io, parsed, await renderedOutput({ result, format, tool: toolName, client, now: deps.now ?? (() => /* @__PURE__ */ new Date()) }));
|
|
838
|
+
return hasIncompleteCheckEvidence(structured.data) ? 4 : 0;
|
|
839
|
+
}
|
|
840
|
+
async function readDomains(io, path) {
|
|
841
|
+
let text;
|
|
842
|
+
try {
|
|
843
|
+
text = await io.readTextFile(path);
|
|
844
|
+
} catch (error) {
|
|
845
|
+
const message = error instanceof Error ? error.message : "read failed";
|
|
846
|
+
throw new CliUsageError(`Could not read ${path}: ${message}`);
|
|
847
|
+
}
|
|
848
|
+
const domains = text.split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#"));
|
|
849
|
+
if (domains.length < 1 || domains.length > 10) throw new CliUsageError("Batch file must contain 1 to 10 domains");
|
|
850
|
+
return domains;
|
|
851
|
+
}
|
|
852
|
+
async function runBatch(parsed, deps) {
|
|
853
|
+
assertOptions(parsed, ["--format", "--out", "--file", "--policy", "--fail-below"], ["--force-refresh", "--force"]);
|
|
854
|
+
if (parsed.positionals.length !== 0) throw new CliUsageError("Batch accepts domains only through --file");
|
|
855
|
+
const file = parsed.values.get("--file");
|
|
856
|
+
if (!file) throw new CliUsageError("Batch requires --file");
|
|
857
|
+
const format = outputFormat(parsed);
|
|
858
|
+
const domains = await readDomains(deps.io, file);
|
|
859
|
+
const baseline = await loadPolicy(parsed, deps.io);
|
|
860
|
+
const client = await connectedClient(deps);
|
|
861
|
+
const result = await client.callTool(
|
|
862
|
+
"batch_scan",
|
|
863
|
+
{
|
|
864
|
+
domains,
|
|
865
|
+
format: "full",
|
|
866
|
+
...parsed.flags.has("--force-refresh") ? { force_refresh: true } : {}
|
|
867
|
+
},
|
|
868
|
+
{ readOnly: true }
|
|
869
|
+
);
|
|
870
|
+
const errorExit = classifyToolError(result, deps.io, "batch_scan");
|
|
871
|
+
if (errorExit !== void 0) return errorExit;
|
|
872
|
+
const structured = BatchResultSchema.safeParse(requireStructured(result, "batch_scan"));
|
|
873
|
+
if (!structured.success) throw new McpClientError("batch_scan returned malformed structuredContent", "protocol");
|
|
874
|
+
await emit(deps.io, parsed, await renderedOutput({ result, format, tool: "batch_scan", client, now: deps.now ?? (() => /* @__PURE__ */ new Date()) }));
|
|
875
|
+
const codes = structured.data.results.map(scanExit);
|
|
876
|
+
if (baseline) {
|
|
877
|
+
for (const scan of structured.data.results) {
|
|
878
|
+
if (scanExit(scan) !== 0) continue;
|
|
879
|
+
codes.push((await callPolicy(client, scan.domain, baseline, deps.io)).exit);
|
|
880
|
+
}
|
|
881
|
+
}
|
|
882
|
+
return combineBatchExitCodes(codes);
|
|
883
|
+
}
|
|
884
|
+
async function runPolicy(parsed, deps) {
|
|
885
|
+
assertOptions(parsed, ["--format", "--out", "--policy", "--fail-below"], ["--force"]);
|
|
886
|
+
const domain = requiredSinglePosition(parsed, "domain");
|
|
887
|
+
const baseline = await loadPolicy(parsed, deps.io);
|
|
888
|
+
if (!baseline) throw new CliUsageError("Policy requires --policy or --fail-below");
|
|
889
|
+
const format = outputFormat(parsed);
|
|
890
|
+
const client = await connectedClient(deps);
|
|
891
|
+
const evaluated = await callPolicy(client, domain, baseline, deps.io);
|
|
892
|
+
if (evaluated.exit === 2 || evaluated.exit === 3) return evaluated.exit;
|
|
893
|
+
await emit(
|
|
894
|
+
deps.io,
|
|
895
|
+
parsed,
|
|
896
|
+
await renderedOutput({ result: evaluated.result, format, tool: "compare_baseline", client, now: deps.now ?? (() => /* @__PURE__ */ new Date()) })
|
|
897
|
+
);
|
|
898
|
+
return evaluated.exit;
|
|
899
|
+
}
|
|
900
|
+
function driftBaselineFromScan(scan) {
|
|
901
|
+
if (scan.score === null || scan.grade === null) throw new CliUsageError("An ungraded scan cannot be used as a drift baseline");
|
|
902
|
+
return {
|
|
903
|
+
overall: scan.score,
|
|
904
|
+
grade: scan.grade,
|
|
905
|
+
categoryScores: Object.fromEntries(Object.entries(scan.categoryScores).filter((entry) => entry[1] !== null)),
|
|
906
|
+
findings: scan.findings
|
|
907
|
+
};
|
|
908
|
+
}
|
|
909
|
+
function driftSaveDomain(parsed) {
|
|
910
|
+
assertOptions(parsed, ["--out"], ["--force-refresh", "--force"]);
|
|
911
|
+
const domain = requiredSinglePosition(parsed, "domain");
|
|
912
|
+
if (!parsed.values.get("--out")) throw new CliUsageError("drift save requires --out");
|
|
913
|
+
return domain;
|
|
914
|
+
}
|
|
915
|
+
function callDriftSaveScan(client, domain, forceRefresh) {
|
|
916
|
+
return client.callTool(
|
|
917
|
+
"scan_domain",
|
|
918
|
+
{
|
|
919
|
+
domain,
|
|
920
|
+
format: "full",
|
|
921
|
+
...forceRefresh ? { force_refresh: true } : {}
|
|
922
|
+
},
|
|
923
|
+
{ readOnly: true }
|
|
924
|
+
);
|
|
925
|
+
}
|
|
926
|
+
async function runDriftSave(parsed, deps) {
|
|
927
|
+
const domain = driftSaveDomain(parsed);
|
|
928
|
+
const client = await connectedClient(deps);
|
|
929
|
+
const result = await callDriftSaveScan(client, domain, parsed.flags.has("--force-refresh"));
|
|
930
|
+
const errorExit = classifyToolError(result, deps.io, "scan_domain");
|
|
931
|
+
if (errorExit !== void 0) return errorExit;
|
|
932
|
+
const structured = ScanResultSchema.safeParse(requireStructured(result, "scan_domain"));
|
|
933
|
+
if (!structured.success) throw new McpClientError("scan_domain returned malformed structuredContent", "protocol");
|
|
934
|
+
await emit(
|
|
935
|
+
deps.io,
|
|
936
|
+
parsed,
|
|
937
|
+
await renderedOutput({ result, format: "evidence", tool: "scan_domain", client, now: deps.now ?? (() => /* @__PURE__ */ new Date()) })
|
|
938
|
+
);
|
|
939
|
+
return scanExit(structured.data);
|
|
940
|
+
}
|
|
941
|
+
async function loadVerifiedEvidence(io, path) {
|
|
942
|
+
const raw = await parseJsonFile(io, path);
|
|
943
|
+
let verification;
|
|
944
|
+
try {
|
|
945
|
+
verification = await verifyEvidenceSnapshot(raw);
|
|
946
|
+
} catch (error) {
|
|
947
|
+
const message = error instanceof Error ? error.message : "schema validation failed";
|
|
948
|
+
throw new CliUsageError(`Invalid evidence snapshot: ${message}`);
|
|
949
|
+
}
|
|
950
|
+
if (!verification.valid) throw new CliVerificationError("Evidence snapshot integrity verification failed");
|
|
951
|
+
return verification.snapshot;
|
|
952
|
+
}
|
|
953
|
+
async function runDriftCompare(parsed, deps) {
|
|
954
|
+
assertOptions(parsed, ["--format", "--out", "--baseline"], ["--force"]);
|
|
955
|
+
const domain = requiredSinglePosition(parsed, "domain");
|
|
956
|
+
const baselinePath = parsed.values.get("--baseline");
|
|
957
|
+
if (!baselinePath) throw new CliUsageError("drift compare requires --baseline");
|
|
958
|
+
const evidence = await loadVerifiedEvidence(deps.io, baselinePath);
|
|
959
|
+
if (evidence.source.tool !== "scan_domain") throw new CliUsageError("Drift baseline evidence must come from scan_domain");
|
|
960
|
+
const scan = ScanResultSchema.safeParse(evidence.result);
|
|
961
|
+
if (!scan.success) throw new CliUsageError("Drift baseline does not contain a valid scan result");
|
|
962
|
+
if (scan.data.domain !== domain) throw new CliUsageError("Drift baseline domain does not match the requested domain");
|
|
963
|
+
if (scanExit(scan.data) !== 0) {
|
|
964
|
+
deps.io.stderr("Drift baseline contains incomplete scan evidence. Save a complete scan before comparing drift.\n");
|
|
965
|
+
return 4;
|
|
966
|
+
}
|
|
967
|
+
const baseline = driftBaselineFromScan(scan.data);
|
|
968
|
+
const format = outputFormat(parsed);
|
|
969
|
+
const client = await connectedClient(deps);
|
|
970
|
+
const result = await client.callTool("analyze_drift", { domain, baseline: JSON.stringify(baseline), format: "full" }, { readOnly: true });
|
|
971
|
+
const errorExit = classifyToolError(result, deps.io, "analyze_drift");
|
|
972
|
+
if (errorExit !== void 0) return errorExit;
|
|
973
|
+
const structured = DriftResultSchema.safeParse(requireStructured(result, "analyze_drift"));
|
|
974
|
+
if (!structured.success) throw new McpClientError("analyze_drift returned malformed structuredContent", "protocol");
|
|
975
|
+
await emit(deps.io, parsed, await renderedOutput({ result, format, tool: "analyze_drift", client, now: deps.now ?? (() => /* @__PURE__ */ new Date()) }));
|
|
976
|
+
return structured.data.classification === "inconclusive" ? 4 : 0;
|
|
977
|
+
}
|
|
978
|
+
async function runEvidenceVerify(parsed, deps) {
|
|
979
|
+
assertOptions(parsed, ["--format"], []);
|
|
980
|
+
const path = requiredSinglePosition(parsed, "evidence file");
|
|
981
|
+
const format = outputFormat(parsed, ["human", "json"]);
|
|
982
|
+
const raw = await parseJsonFile(deps.io, path);
|
|
983
|
+
let verification;
|
|
984
|
+
try {
|
|
985
|
+
verification = await verifyEvidenceSnapshot(raw);
|
|
986
|
+
} catch (error) {
|
|
987
|
+
const message = error instanceof Error ? error.message : "schema validation failed";
|
|
988
|
+
throw new CliUsageError(`Invalid evidence snapshot: ${message}`);
|
|
989
|
+
}
|
|
990
|
+
if (format === "json") {
|
|
991
|
+
deps.io.stdout(
|
|
992
|
+
`${JSON.stringify({ valid: verification.valid, expectedDigest: verification.expectedDigest, actualDigest: verification.actualDigest }, null, 2)}
|
|
993
|
+
`
|
|
994
|
+
);
|
|
995
|
+
} else {
|
|
996
|
+
deps.io.stdout(
|
|
997
|
+
verification.valid ? `VALID ${verification.actualDigest}
|
|
998
|
+
` : `INVALID expected ${verification.expectedDigest} but computed ${verification.actualDigest}
|
|
999
|
+
`
|
|
1000
|
+
);
|
|
1001
|
+
}
|
|
1002
|
+
return verification.valid ? 0 : 1;
|
|
1003
|
+
}
|
|
1004
|
+
async function runCli(argv, deps) {
|
|
1005
|
+
if (isHelpRequest(argv)) {
|
|
1006
|
+
deps.io.stdout(HELP);
|
|
1007
|
+
return 0;
|
|
1008
|
+
}
|
|
1009
|
+
try {
|
|
1010
|
+
const commandDeps = withDeadline(deps);
|
|
1011
|
+
const [command, ...rest] = argv;
|
|
1012
|
+
const parsed = parseArgs(rest);
|
|
1013
|
+
return await commandHandler(command)(parsed, rest, commandDeps);
|
|
1014
|
+
} catch (error) {
|
|
1015
|
+
return reportCliFailure(error, deps.io);
|
|
1016
|
+
}
|
|
1017
|
+
}
|
|
1018
|
+
function withDeadline(deps) {
|
|
1019
|
+
return { ...deps, deadlineAt: deps.deadlineAt ?? (deps.nowMs ?? Date.now)() + 45e3 };
|
|
1020
|
+
}
|
|
1021
|
+
function commandHandler(command) {
|
|
1022
|
+
const handler = COMMAND_HANDLERS.get(command);
|
|
1023
|
+
if (!handler) throw new CliUsageError(`Unknown command ${command}`);
|
|
1024
|
+
return handler;
|
|
1025
|
+
}
|
|
1026
|
+
function isHelpRequest(argv) {
|
|
1027
|
+
return argv.length === 0 || argv[0] === "--help" || argv[0] === "-h" || argv[0] === "help";
|
|
1028
|
+
}
|
|
1029
|
+
async function runDrift(rest, deps) {
|
|
1030
|
+
const [subcommand, ...subcommandArgs] = rest;
|
|
1031
|
+
if (!subcommand) throw new CliUsageError("drift requires save or compare");
|
|
1032
|
+
const driftParsed = parseArgs(subcommandArgs);
|
|
1033
|
+
if (subcommand === "save") return await runDriftSave(driftParsed, deps);
|
|
1034
|
+
if (subcommand === "compare") return await runDriftCompare(driftParsed, deps);
|
|
1035
|
+
throw new CliUsageError("drift requires save or compare");
|
|
1036
|
+
}
|
|
1037
|
+
async function runEvidence(rest, deps) {
|
|
1038
|
+
const [subcommand, ...subcommandArgs] = rest;
|
|
1039
|
+
if (subcommand !== "verify") throw new CliUsageError("evidence requires verify");
|
|
1040
|
+
return await runEvidenceVerify(parseArgs(subcommandArgs), deps);
|
|
1041
|
+
}
|
|
1042
|
+
var COMMAND_HANDLERS = /* @__PURE__ */ new Map([
|
|
1043
|
+
["scan", (parsed, _rest, deps) => runScan(parsed, deps)],
|
|
1044
|
+
["check", (parsed, _rest, deps) => runCheck(parsed, deps)],
|
|
1045
|
+
["batch", (parsed, _rest, deps) => runBatch(parsed, deps)],
|
|
1046
|
+
["policy", (parsed, _rest, deps) => runPolicy(parsed, deps)],
|
|
1047
|
+
["drift", (_parsed, rest, deps) => runDrift(rest, deps)],
|
|
1048
|
+
["evidence", (_parsed, rest, deps) => runEvidence(rest, deps)]
|
|
1049
|
+
]);
|
|
1050
|
+
function reportCliFailure(error, io) {
|
|
1051
|
+
if (error instanceof CliVerificationError) {
|
|
1052
|
+
io.stderr(`${sanitizeDiagnostic(error.message)}
|
|
1053
|
+
`);
|
|
1054
|
+
return 1;
|
|
1055
|
+
}
|
|
1056
|
+
if (error instanceof CliUsageError) {
|
|
1057
|
+
io.stderr(`${sanitizeDiagnostic(error.message)}
|
|
1058
|
+
Run blackveil --help for usage.
|
|
1059
|
+
`);
|
|
1060
|
+
return 2;
|
|
1061
|
+
}
|
|
1062
|
+
if (error instanceof McpClientError) {
|
|
1063
|
+
io.stderr(`${sanitizeDiagnostic(error.message)}
|
|
1064
|
+
`);
|
|
1065
|
+
return 3;
|
|
1066
|
+
}
|
|
1067
|
+
io.stderr(`${sanitizeDiagnostic(error instanceof Error ? error.message : "Unexpected CLI failure")}
|
|
1068
|
+
`);
|
|
1069
|
+
return 3;
|
|
1070
|
+
}
|
|
1071
|
+
|
|
1072
|
+
// src/cli.ts
|
|
1073
|
+
async function runBlackveilCli(argv = process.argv.slice(2)) {
|
|
1074
|
+
return runCli(argv, {
|
|
1075
|
+
env: process.env,
|
|
1076
|
+
io: {
|
|
1077
|
+
readTextFile: (path) => readFile(path, "utf8"),
|
|
1078
|
+
writeTextFile: async (path, content, overwrite) => {
|
|
1079
|
+
await writeFile(path, content, { encoding: "utf8", flag: overwrite ? "w" : "wx" });
|
|
1080
|
+
},
|
|
1081
|
+
stdout: (text) => {
|
|
1082
|
+
process.stdout.write(text);
|
|
1083
|
+
},
|
|
1084
|
+
stderr: (text) => {
|
|
1085
|
+
process.stderr.write(text);
|
|
1086
|
+
}
|
|
1087
|
+
}
|
|
1088
|
+
});
|
|
1089
|
+
}
|
|
1090
|
+
if (import.meta.url.endsWith("/cli.js")) {
|
|
1091
|
+
void runBlackveilCli().then((exitCode) => {
|
|
1092
|
+
process.exitCode = exitCode;
|
|
1093
|
+
});
|
|
1094
|
+
}
|
|
1095
|
+
|
|
1096
|
+
export { runBlackveilCli };
|
|
1097
|
+
//# sourceMappingURL=cli.js.map
|
|
1098
|
+
//# sourceMappingURL=cli.js.map
|