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.
Files changed (640) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +237 -62
  3. package/dist/cli.js +1098 -0
  4. package/dist/cli.js.map +1 -0
  5. package/dist/index.js +10011 -2433
  6. package/dist/index.js.map +1 -1
  7. package/dist/stdio.js +33244 -9766
  8. package/dist/stdio.js.map +1 -1
  9. package/package.json +101 -21
  10. package/.claude/settings.json +0 -61
  11. package/.cursorrules +0 -1
  12. package/.devcontainer/Dockerfile +0 -17
  13. package/.devcontainer/devcontainer.json +0 -18
  14. package/.editorconfig +0 -12
  15. package/.gitattributes +0 -24
  16. package/.githooks/blocked-patterns +0 -13
  17. package/.githooks/pre-commit +0 -127
  18. package/.github/CODEOWNERS +0 -11
  19. package/.github/ISSUE_TEMPLATE/bug_report.yml +0 -99
  20. package/.github/ISSUE_TEMPLATE/config.yml +0 -11
  21. package/.github/ISSUE_TEMPLATE/feature_request.yml +0 -51
  22. package/.github/PULL_REQUEST_TEMPLATE.md +0 -30
  23. package/.github/copilot-instructions.md +0 -73
  24. package/.github/dependabot.yml +0 -22
  25. package/.github/instructions/scan-orchestration.instructions.md +0 -56
  26. package/.github/instructions/schemas.instructions.md +0 -52
  27. package/.github/instructions/security.instructions.md +0 -77
  28. package/.github/instructions/tests.instructions.md +0 -31
  29. package/.github/instructions/tools.instructions.md +0 -55
  30. package/.github/workflows/auto-deploy-main.yml.disabled +0 -145
  31. package/.github/workflows/ci-contract.yml +0 -47
  32. package/.github/workflows/ci.yml +0 -53
  33. package/.github/workflows/deploy-hook.yml +0 -113
  34. package/.github/workflows/dns-security.yml +0 -32
  35. package/.github/workflows/publish.yml +0 -275
  36. package/.github/workflows/repo-hygiene.yml +0 -121
  37. package/.github/workflows/security.yml +0 -62
  38. package/.github/workflows/triage-issues.yml +0 -82
  39. package/.gitleaks.toml +0 -190
  40. package/.intent/.gitignore +0 -5
  41. package/.intent/config.json +0 -88
  42. package/.nvmrc +0 -1
  43. package/.phase2-queue/baseline.txt +0 -1
  44. package/.prettierrc +0 -6
  45. package/CHANGELOG.md +0 -793
  46. package/CLAUDE.md +0 -580
  47. package/CODE_OF_CONDUCT.md +0 -133
  48. package/CONTRIBUTING.md +0 -63
  49. package/SECURITY.md +0 -66
  50. package/SUPPORT.md +0 -17
  51. package/assets/brave-score.png +0 -0
  52. package/assets/bv-logo-full.png +0 -0
  53. package/assets/bv-logo-mark.png +0 -0
  54. package/assets/our-listing-final.png +0 -0
  55. package/assets/smithery-listing.png +0 -0
  56. package/assets/smithery-score-2.png +0 -0
  57. package/assets/smithery-score-hover.png +0 -0
  58. package/assets/smithery-score.png +0 -0
  59. package/assets/supabase-score.png +0 -0
  60. package/conductor/index.md +0 -1
  61. package/conductor/registrar-commercial-models.md +0 -64
  62. package/crates/bv-wasm-core/Cargo.lock +0 -177
  63. package/crates/bv-wasm-core/Cargo.toml +0 -12
  64. package/crates/bv-wasm-core/src/compact.rs +0 -60
  65. package/crates/bv-wasm-core/src/lib.rs +0 -116
  66. package/crates/bv-wasm-core/src/permissions.rs +0 -106
  67. package/dist/index.d.ts +0 -500
  68. package/dist/stdio.d.ts +0 -12
  69. package/docs/client-setup.md +0 -587
  70. package/docs/scoring.md +0 -245
  71. package/docs/style-guide.md +0 -69
  72. package/docs/tenant-Capacity-and-Discovery-Design.md +0 -267
  73. package/docs/tenant-Scalable-Architecture-Design.md +0 -639
  74. package/docs/tenant-ops-runbook.md +0 -191
  75. package/docs/troubleshooting.md +0 -392
  76. package/eslint.config.mjs +0 -21
  77. package/examples/slack-discord-webhook/README.md +0 -38
  78. package/examples/slack-discord-webhook/worker.ts +0 -133
  79. package/examples/slack-discord-webhook/wrangler.toml +0 -11
  80. package/extensions/vscode/.vscodeignore +0 -2
  81. package/extensions/vscode/CHANGELOG.md +0 -8
  82. package/extensions/vscode/LICENSE +0 -76
  83. package/extensions/vscode/README.md +0 -105
  84. package/extensions/vscode/icon.png +0 -0
  85. package/extensions/vscode/package.json +0 -49
  86. package/packages/dns-checks/LICENSE +0 -76
  87. package/packages/dns-checks/README.md +0 -61
  88. package/packages/dns-checks/package.json +0 -39
  89. package/packages/dns-checks/src/__tests__/check-utils.test.ts +0 -188
  90. package/packages/dns-checks/src/__tests__/checks/check-dkim.test.ts +0 -54
  91. package/packages/dns-checks/src/__tests__/checks/check-dmarc.test.ts +0 -70
  92. package/packages/dns-checks/src/__tests__/checks/check-dnssec.test.ts +0 -56
  93. package/packages/dns-checks/src/__tests__/checks/check-remaining.test.ts +0 -244
  94. package/packages/dns-checks/src/__tests__/checks/check-spf.test.ts +0 -114
  95. package/packages/dns-checks/src/__tests__/scoring/generic-engine.spec.ts +0 -858
  96. package/packages/dns-checks/src/__tests__/scoring/score-determinism.spec.ts +0 -73
  97. package/packages/dns-checks/src/__tests__/scoring/scoring-config.spec.ts +0 -194
  98. package/packages/dns-checks/src/__tests__/scoring/scoring-engine.spec.ts +0 -137
  99. package/packages/dns-checks/src/__tests__/scoring/scoring-model.spec.ts +0 -46
  100. package/packages/dns-checks/src/__tests__/scoring/scoring-profiles.spec.ts +0 -316
  101. package/packages/dns-checks/src/__tests__/scoring-schemas.test.ts +0 -307
  102. package/packages/dns-checks/src/check-utils.ts +0 -44
  103. package/packages/dns-checks/src/checks/caa-analysis.ts +0 -126
  104. package/packages/dns-checks/src/checks/check-bimi.ts +0 -305
  105. package/packages/dns-checks/src/checks/check-caa.ts +0 -63
  106. package/packages/dns-checks/src/checks/check-dane-https.ts +0 -88
  107. package/packages/dns-checks/src/checks/check-dane.ts +0 -110
  108. package/packages/dns-checks/src/checks/check-dkim.ts +0 -261
  109. package/packages/dns-checks/src/checks/check-dmarc.ts +0 -370
  110. package/packages/dns-checks/src/checks/check-dnssec.ts +0 -131
  111. package/packages/dns-checks/src/checks/check-http-security.ts +0 -187
  112. package/packages/dns-checks/src/checks/check-mta-sts.ts +0 -195
  113. package/packages/dns-checks/src/checks/check-mx.ts +0 -130
  114. package/packages/dns-checks/src/checks/check-ns.ts +0 -133
  115. package/packages/dns-checks/src/checks/check-spf.ts +0 -271
  116. package/packages/dns-checks/src/checks/check-ssl.ts +0 -95
  117. package/packages/dns-checks/src/checks/check-subdomailing.ts +0 -77
  118. package/packages/dns-checks/src/checks/check-subdomain-takeover.ts +0 -45
  119. package/packages/dns-checks/src/checks/check-svcb-https.ts +0 -246
  120. package/packages/dns-checks/src/checks/check-tlsrpt.ts +0 -112
  121. package/packages/dns-checks/src/checks/dane-analysis.ts +0 -203
  122. package/packages/dns-checks/src/checks/dkim-analysis.ts +0 -102
  123. package/packages/dns-checks/src/checks/dmarc-utils.ts +0 -126
  124. package/packages/dns-checks/src/checks/dnssec-analysis.ts +0 -237
  125. package/packages/dns-checks/src/checks/http-security-analysis.ts +0 -230
  126. package/packages/dns-checks/src/checks/index.ts +0 -36
  127. package/packages/dns-checks/src/checks/mta-sts-analysis.ts +0 -259
  128. package/packages/dns-checks/src/checks/mx-analysis.ts +0 -63
  129. package/packages/dns-checks/src/checks/ns-analysis.ts +0 -171
  130. package/packages/dns-checks/src/checks/spf-analysis.ts +0 -211
  131. package/packages/dns-checks/src/checks/spf-trust-surface.ts +0 -141
  132. package/packages/dns-checks/src/checks/ssl-analysis.ts +0 -111
  133. package/packages/dns-checks/src/checks/subdomailing-analysis.ts +0 -262
  134. package/packages/dns-checks/src/checks/subdomain-takeover-analysis.ts +0 -217
  135. package/packages/dns-checks/src/index.ts +0 -73
  136. package/packages/dns-checks/src/schemas/scoring.ts +0 -52
  137. package/packages/dns-checks/src/scoring/config.ts +0 -346
  138. package/packages/dns-checks/src/scoring/engine.ts +0 -293
  139. package/packages/dns-checks/src/scoring/generic.ts +0 -317
  140. package/packages/dns-checks/src/scoring/index.ts +0 -56
  141. package/packages/dns-checks/src/scoring/model.ts +0 -133
  142. package/packages/dns-checks/src/scoring/profiles.ts +0 -332
  143. package/packages/dns-checks/src/types.ts +0 -172
  144. package/packages/dns-checks/tsconfig.json +0 -15
  145. package/packages/dns-checks/tsup.config.ts +0 -14
  146. package/packages/dns-checks/vitest.config.ts +0 -8
  147. package/public/index.html +0 -45
  148. package/scripts/benchmark-doh.mjs +0 -216
  149. package/scripts/benchmark.sh +0 -151
  150. package/scripts/chaos/chaos-run.py +0 -393
  151. package/scripts/chaos/chaos-test-clients.py +0 -884
  152. package/scripts/chaos/chaos-test-msp.py +0 -745
  153. package/scripts/chaos/chaos-test-v205.py +0 -829
  154. package/scripts/chaos/chaos-test-v210.py +0 -2038
  155. package/scripts/chaos/chaos-test-wasm.py +0 -65
  156. package/scripts/chaos/chaos-test.py +0 -952
  157. package/scripts/chaos/score-stability-test.py +0 -298
  158. package/scripts/chaos/tenant-chaos-v3.py +0 -119
  159. package/scripts/context-usage-test.py +0 -281
  160. package/scripts/conversation-sim.py +0 -421
  161. package/scripts/deploy-private.mjs +0 -22
  162. package/scripts/generate-report.sh +0 -42
  163. package/scripts/inject-private-config.cjs +0 -41
  164. package/scripts/maintenance/dispatch_all.sh +0 -26
  165. package/scripts/maintenance/fix_wrangler.py +0 -32
  166. package/scripts/maintenance/run_rescan_prod.py +0 -34
  167. package/scripts/maintenance/run_sync_batches.py +0 -56
  168. package/scripts/maintenance/run_sync_test.py +0 -27
  169. package/scripts/maintenance/run_test_msg.py +0 -22
  170. package/scripts/maintenance/test_analytics_stream.js +0 -3
  171. package/scripts/maintenance/update_wrangler.cjs +0 -22
  172. package/scripts/maintenance/update_wrangler.js +0 -22
  173. package/scripts/maintenance/validate-internal-deps.mjs +0 -49
  174. package/scripts/oauth/README.md +0 -101
  175. package/scripts/oauth/prod-probe.py +0 -329
  176. package/scripts/output-usage-test.py +0 -221
  177. package/scripts/pressure-chaos-test.mjs +0 -481
  178. package/scripts/tenants/add_consumer.js +0 -17
  179. package/scripts/tenants/calibrate.mjs +0 -206
  180. package/scripts/tenants/provision-tenant.mjs +0 -578
  181. package/scripts/tenants/register_domains.py +0 -27
  182. package/scripts/tenants/sql/register_0.sql +0 -1
  183. package/scripts/tenants/sql/register_1.sql +0 -1
  184. package/scripts/tenants/sql/register_2.sql +0 -1
  185. package/scripts/tenants/sql/register_3.sql +0 -1
  186. package/scripts/tenants/sql/register_4.sql +0 -1
  187. package/scripts/tenants/sql/register_5.sql +0 -1
  188. package/scripts/tenants/sql/register_6.sql +0 -1
  189. package/scripts/tenants/sql/register_7.sql +0 -1
  190. package/scripts/tenants/sql/register_8.sql +0 -1
  191. package/scripts/tenants/sql/register_9.sql +0 -1
  192. package/scripts/tranco-deep-2026-04-05_12h42m.json +0 -47002
  193. package/scripts/tranco-deep-scan.mjs +0 -307
  194. package/scripts/tranco-scan-2026-04-05_12h14m.json +0 -6002
  195. package/scripts/tranco-scan-2026-04-06_02h49m.json +0 -602
  196. package/scripts/tranco-scan-2026-04-07_13h30m.json +0 -1202
  197. package/scripts/tranco-scan.mjs +0 -253
  198. package/scripts/trial-key.mjs +0 -346
  199. package/server.json +0 -35
  200. package/smithery.yaml +0 -13
  201. package/src/handlers/prompts.ts +0 -279
  202. package/src/handlers/resources.ts +0 -283
  203. package/src/handlers/tool-args.ts +0 -150
  204. package/src/handlers/tool-execution.ts +0 -107
  205. package/src/handlers/tool-formatters.ts +0 -94
  206. package/src/handlers/tool-schemas.ts +0 -9
  207. package/src/handlers/tools.ts +0 -529
  208. package/src/index.ts +0 -794
  209. package/src/internal.ts +0 -666
  210. package/src/lib/adaptive-weights.ts +0 -246
  211. package/src/lib/alerting.ts +0 -103
  212. package/src/lib/analytics-engine.ts +0 -33
  213. package/src/lib/analytics-queries.ts +0 -399
  214. package/src/lib/analytics.ts +0 -310
  215. package/src/lib/audit.ts +0 -56
  216. package/src/lib/auth.ts +0 -52
  217. package/src/lib/badge.ts +0 -94
  218. package/src/lib/cache.ts +0 -310
  219. package/src/lib/category-interactions.ts +0 -154
  220. package/src/lib/circuit-breaker.ts +0 -101
  221. package/src/lib/client-detection.ts +0 -31
  222. package/src/lib/config.ts +0 -370
  223. package/src/lib/context-profiles.ts +0 -16
  224. package/src/lib/db/schema.ts +0 -77
  225. package/src/lib/dns-multi-resolver.ts +0 -218
  226. package/src/lib/dns-query-adapter.ts +0 -18
  227. package/src/lib/dns-records.ts +0 -233
  228. package/src/lib/dns-transport.ts +0 -237
  229. package/src/lib/dns-types.ts +0 -91
  230. package/src/lib/dns.ts +0 -27
  231. package/src/lib/fuzzing-counter.ts +0 -79
  232. package/src/lib/fuzzing-detector.ts +0 -115
  233. package/src/lib/hooks/analytics-stream.ts +0 -28
  234. package/src/lib/ip-utils.ts +0 -70
  235. package/src/lib/json-rpc.ts +0 -67
  236. package/src/lib/legacy-sse.ts +0 -185
  237. package/src/lib/log.ts +0 -113
  238. package/src/lib/output-sanitize.ts +0 -40
  239. package/src/lib/profile-accumulator.ts +0 -830
  240. package/src/lib/provider-signature-source.ts +0 -191
  241. package/src/lib/provider-signatures.ts +0 -134
  242. package/src/lib/public-suffix.ts +0 -131
  243. package/src/lib/quota-coordinator.ts +0 -446
  244. package/src/lib/rate-limiter-memory.ts +0 -163
  245. package/src/lib/rate-limiter.ts +0 -528
  246. package/src/lib/safe-fetch.ts +0 -42
  247. package/src/lib/sanitize.ts +0 -245
  248. package/src/lib/scoring-config.ts +0 -36
  249. package/src/lib/scoring-engine.ts +0 -15
  250. package/src/lib/scoring-model.ts +0 -26
  251. package/src/lib/scoring.ts +0 -58
  252. package/src/lib/semaphore.ts +0 -101
  253. package/src/lib/server-version.ts +0 -4
  254. package/src/lib/session-memory.ts +0 -177
  255. package/src/lib/session.ts +0 -295
  256. package/src/lib/sse.ts +0 -174
  257. package/src/lib/tier-auth.ts +0 -237
  258. package/src/lib/trial-keys.ts +0 -217
  259. package/src/mcp/dispatch.ts +0 -222
  260. package/src/mcp/execute.ts +0 -680
  261. package/src/mcp/request.ts +0 -152
  262. package/src/mcp/route-gates.ts +0 -119
  263. package/src/oauth/authorize.ts +0 -268
  264. package/src/oauth/discovery.ts +0 -48
  265. package/src/oauth/entitlements.ts +0 -77
  266. package/src/oauth/jwt.ts +0 -142
  267. package/src/oauth/register.ts +0 -72
  268. package/src/oauth/storage.ts +0 -66
  269. package/src/oauth/token.ts +0 -171
  270. package/src/package.ts +0 -59
  271. package/src/scheduled.ts +0 -310
  272. package/src/schemas/alerting.ts +0 -49
  273. package/src/schemas/audit.ts +0 -39
  274. package/src/schemas/auth.ts +0 -27
  275. package/src/schemas/dns.ts +0 -49
  276. package/src/schemas/internal.ts +0 -26
  277. package/src/schemas/json-rpc.ts +0 -20
  278. package/src/schemas/oauth.ts +0 -120
  279. package/src/schemas/primitives.ts +0 -58
  280. package/src/schemas/session.ts +0 -9
  281. package/src/schemas/tenant-alerts.ts +0 -118
  282. package/src/schemas/tenant-internal.ts +0 -143
  283. package/src/schemas/tool-args.ts +0 -270
  284. package/src/schemas/tool-definitions.ts +0 -452
  285. package/src/stdio.ts +0 -183
  286. package/src/tenants/adapters/tenant-d1.ts +0 -51
  287. package/src/tenants/adapters/tenant-kv.ts +0 -64
  288. package/src/tenants/adapters/tenant-r2.ts +0 -69
  289. package/src/tenants/alerts/diff.ts +0 -201
  290. package/src/tenants/alerts/index.ts +0 -12
  291. package/src/tenants/alerts/webhook.ts +0 -141
  292. package/src/tenants/analytics-stream.ts +0 -26
  293. package/src/tenants/audit.ts +0 -123
  294. package/src/tenants/db/drizzle.registry.config.ts +0 -18
  295. package/src/tenants/db/drizzle.tenant.config.ts +0 -21
  296. package/src/tenants/db/index.ts +0 -19
  297. package/src/tenants/db/migrations/registry/0000_minor_skaar.sql +0 -46
  298. package/src/tenants/db/migrations/registry/0001_wet_warhawk.sql +0 -23
  299. package/src/tenants/db/migrations/registry/0002_big_speedball.sql +0 -17
  300. package/src/tenants/db/migrations/registry/meta/0000_snapshot.json +0 -330
  301. package/src/tenants/db/migrations/registry/meta/0001_snapshot.json +0 -498
  302. package/src/tenants/db/migrations/registry/meta/0002_snapshot.json +0 -624
  303. package/src/tenants/db/migrations/registry/meta/_journal.json +0 -27
  304. package/src/tenants/db/migrations/tenant/0000_clear_clea.sql +0 -54
  305. package/src/tenants/db/migrations/tenant/0001_clumsy_master_mold.sql +0 -3
  306. package/src/tenants/db/migrations/tenant/meta/0000_snapshot.json +0 -375
  307. package/src/tenants/db/migrations/tenant/meta/0001_snapshot.json +0 -397
  308. package/src/tenants/db/migrations/tenant/meta/_journal.json +0 -20
  309. package/src/tenants/db/schema/registry.ts +0 -154
  310. package/src/tenants/db/schema/tenant.ts +0 -106
  311. package/src/tenants/discovery/dkim-key-reuse.ts +0 -250
  312. package/src/tenants/discovery/dmarc-rua-miner.ts +0 -186
  313. package/src/tenants/discovery/index.ts +0 -31
  314. package/src/tenants/discovery/ns-correlator.ts +0 -155
  315. package/src/tenants/discovery/san-correlator.ts +0 -212
  316. package/src/tenants/dns-fingerprint.ts +0 -313
  317. package/src/tenants/monitoring/index.ts +0 -17
  318. package/src/tenants/per-tenant-rate-limit.ts +0 -148
  319. package/src/tenants/queue-consumer.ts +0 -375
  320. package/src/tenants/routes.ts +0 -1014
  321. package/src/tenants/scheduled-handlers.ts +0 -550
  322. package/src/tenants/tenant-resolver.ts +0 -143
  323. package/src/tools/analyze-drift.ts +0 -235
  324. package/src/tools/assess-spoofability.ts +0 -224
  325. package/src/tools/batch-scan.ts +0 -163
  326. package/src/tools/caa-analysis.ts +0 -72
  327. package/src/tools/check-bimi.ts +0 -30
  328. package/src/tools/check-caa.ts +0 -23
  329. package/src/tools/check-cymru-asn.ts +0 -175
  330. package/src/tools/check-dane-https.ts +0 -29
  331. package/src/tools/check-dane.ts +0 -29
  332. package/src/tools/check-dbl.ts +0 -251
  333. package/src/tools/check-dkim.ts +0 -98
  334. package/src/tools/check-dmarc.ts +0 -25
  335. package/src/tools/check-dnssec-chain.ts +0 -284
  336. package/src/tools/check-dnssec.ts +0 -171
  337. package/src/tools/check-fast-flux.ts +0 -168
  338. package/src/tools/check-http-security.ts +0 -339
  339. package/src/tools/check-lookalikes.ts +0 -379
  340. package/src/tools/check-mta-sts.ts +0 -24
  341. package/src/tools/check-mx-reputation.ts +0 -174
  342. package/src/tools/check-mx.ts +0 -117
  343. package/src/tools/check-ns.ts +0 -30
  344. package/src/tools/check-nsec-walkability.ts +0 -173
  345. package/src/tools/check-rbl.ts +0 -235
  346. package/src/tools/check-rdap-lookup.ts +0 -333
  347. package/src/tools/check-resolver-consistency.ts +0 -151
  348. package/src/tools/check-shadow-domains.ts +0 -517
  349. package/src/tools/check-spf.ts +0 -48
  350. package/src/tools/check-srv.ts +0 -75
  351. package/src/tools/check-ssl.ts +0 -18
  352. package/src/tools/check-subdomailing.ts +0 -22
  353. package/src/tools/check-subdomain-takeover.ts +0 -24
  354. package/src/tools/check-svcb-https.ts +0 -22
  355. package/src/tools/check-tlsrpt.ts +0 -23
  356. package/src/tools/check-txt-hygiene.ts +0 -364
  357. package/src/tools/check-zone-hygiene.ts +0 -154
  358. package/src/tools/compare-baseline.ts +0 -199
  359. package/src/tools/compare-domains.ts +0 -182
  360. package/src/tools/dane-analysis.ts +0 -172
  361. package/src/tools/discover-brand-domains.ts +0 -377
  362. package/src/tools/discover-subdomains.ts +0 -487
  363. package/src/tools/dkim-analysis.ts +0 -86
  364. package/src/tools/dmarc-utils.ts +0 -114
  365. package/src/tools/dnssec-analysis.ts +0 -123
  366. package/src/tools/explain-finding-data.ts +0 -766
  367. package/src/tools/explain-finding.ts +0 -181
  368. package/src/tools/generate-fix-plan.ts +0 -196
  369. package/src/tools/generate-records.ts +0 -412
  370. package/src/tools/generate-rollout-plan.ts +0 -342
  371. package/src/tools/http-security-analysis.ts +0 -192
  372. package/src/tools/intelligence.ts +0 -331
  373. package/src/tools/lookalike-analysis.ts +0 -176
  374. package/src/tools/map-compliance.ts +0 -243
  375. package/src/tools/map-supply-chain.ts +0 -458
  376. package/src/tools/mta-sts-analysis.ts +0 -250
  377. package/src/tools/mx-analysis.ts +0 -55
  378. package/src/tools/mx-reputation-analysis.ts +0 -205
  379. package/src/tools/ns-analysis.ts +0 -162
  380. package/src/tools/provider-guides.ts +0 -404
  381. package/src/tools/resolve-spf-chain.ts +0 -254
  382. package/src/tools/scan/format-report.ts +0 -248
  383. package/src/tools/scan/maturity-staging.ts +0 -166
  384. package/src/tools/scan/post-processing.ts +0 -270
  385. package/src/tools/scan-domain.ts +0 -664
  386. package/src/tools/simulate-attack-paths.ts +0 -513
  387. package/src/tools/spf-analysis.ts +0 -203
  388. package/src/tools/spf-trust-surface.ts +0 -138
  389. package/src/tools/srv-analysis.ts +0 -118
  390. package/src/tools/ssl-analysis.ts +0 -102
  391. package/src/tools/subdomain-takeover-analysis.ts +0 -202
  392. package/src/tools/txt-hygiene-analysis.ts +0 -87
  393. package/src/tools/validate-fix.ts +0 -219
  394. package/src/tools/zone-hygiene-analysis.ts +0 -217
  395. package/src/types/env.d.ts +0 -6
  396. package/test/.!52131!.DS_Store +0 -0
  397. package/test/adaptive-weights.spec.ts +0 -359
  398. package/test/alerting.spec.ts +0 -91
  399. package/test/analytics-ip-hash.spec.ts +0 -90
  400. package/test/analytics-queries.spec.ts +0 -197
  401. package/test/analytics-stream.spec.ts +0 -32
  402. package/test/analytics.spec.ts +0 -205
  403. package/test/analyze-drift.spec.ts +0 -82
  404. package/test/assess-spoofability.spec.ts +0 -186
  405. package/test/audit.spec.ts +0 -250
  406. package/test/audits/fuzzing-config.audit.test.ts +0 -76
  407. package/test/audits/no-tracked-secrets.audit.test.ts +0 -166
  408. package/test/audits/oauth-readiness-gate.audit.test.ts +0 -83
  409. package/test/audits/tenant-capacity-readiness.audit.test.ts +0 -92
  410. package/test/audits/tenant-scale-quota.audit.test.ts +0 -35
  411. package/test/audits/tool-quota-coverage.audit.test.ts +0 -41
  412. package/test/audits/workflow-secret-check.audit.test.ts +0 -79
  413. package/test/auth.spec.ts +0 -94
  414. package/test/badge.spec.ts +0 -112
  415. package/test/batch-scan.spec.ts +0 -141
  416. package/test/caa-analysis.spec.ts +0 -24
  417. package/test/cache.spec.ts +0 -421
  418. package/test/category-interactions.spec.ts +0 -172
  419. package/test/chaos/fuzzing-degradation.chaos.test.ts +0 -50
  420. package/test/chaos/invariants.spec.ts +0 -181
  421. package/test/chaos/oauth-misconfiguration.chaos.test.ts +0 -132
  422. package/test/chaos/tenant-cron.chaos.test.ts +0 -276
  423. package/test/chaos/tenant-queue.chaos.test.ts +0 -272
  424. package/test/check-bimi.spec.ts +0 -160
  425. package/test/check-caa.spec.ts +0 -144
  426. package/test/check-cymru-asn.spec.ts +0 -239
  427. package/test/check-dane-https.spec.ts +0 -203
  428. package/test/check-dane.spec.ts +0 -234
  429. package/test/check-dbl.spec.ts +0 -214
  430. package/test/check-dkim.spec.ts +0 -413
  431. package/test/check-dmarc.spec.ts +0 -377
  432. package/test/check-dnssec-catch.spec.ts +0 -48
  433. package/test/check-dnssec-chain.spec.ts +0 -196
  434. package/test/check-dnssec.spec.ts +0 -271
  435. package/test/check-fast-flux.spec.ts +0 -201
  436. package/test/check-http-security.spec.ts +0 -420
  437. package/test/check-lookalikes.spec.ts +0 -860
  438. package/test/check-mta-sts.spec.ts +0 -196
  439. package/test/check-mx-reputation.spec.ts +0 -395
  440. package/test/check-mx.spec.ts +0 -183
  441. package/test/check-ns.spec.ts +0 -172
  442. package/test/check-nsec-walkability.spec.ts +0 -107
  443. package/test/check-rbl.spec.ts +0 -283
  444. package/test/check-rdap-lookup.spec.ts +0 -235
  445. package/test/check-resolver-consistency.spec.ts +0 -117
  446. package/test/check-shadow-domains.spec.ts +0 -883
  447. package/test/check-spf.spec.ts +0 -399
  448. package/test/check-srv.spec.ts +0 -160
  449. package/test/check-ssl.spec.ts +0 -192
  450. package/test/check-subdomailing.spec.ts +0 -308
  451. package/test/check-subdomain-takeover.spec.ts +0 -366
  452. package/test/check-svcb-https.spec.ts +0 -247
  453. package/test/check-tlsrpt.spec.ts +0 -70
  454. package/test/check-txt-hygiene.spec.ts +0 -414
  455. package/test/check-zone-hygiene.spec.ts +0 -234
  456. package/test/circuit-breaker.spec.ts +0 -171
  457. package/test/client-detection.spec.ts +0 -73
  458. package/test/compare-baseline.spec.ts +0 -221
  459. package/test/compare-domains.spec.ts +0 -46
  460. package/test/config.spec.ts +0 -216
  461. package/test/context-profiles.spec.ts +0 -215
  462. package/test/contracts/fuzzing-alert.contract.test.ts +0 -58
  463. package/test/contracts/oauth-tier.contract.test.ts +0 -53
  464. package/test/contracts/tenant-alerts.contract.test.ts +0 -79
  465. package/test/dane-analysis.spec.ts +0 -165
  466. package/test/data/batch_test.json +0 -1
  467. package/test/data/domains.json +0 -26976
  468. package/test/data/rescan_batch.json +0 -1
  469. package/test/data/sync_test.json +0 -1
  470. package/test/data/temp_sync_batch.json +0 -1
  471. package/test/discover-brand-domains.spec.ts +0 -215
  472. package/test/discover-subdomains.spec.ts +0 -382
  473. package/test/dispatch-reinitialize.spec.ts +0 -101
  474. package/test/dkim-analysis.spec.ts +0 -48
  475. package/test/dmarc-utils.spec.ts +0 -27
  476. package/test/dns-multi-resolver.spec.ts +0 -109
  477. package/test/dns-records-new.spec.ts +0 -244
  478. package/test/dns-records.spec.ts +0 -20
  479. package/test/dns-semaphore.spec.ts +0 -184
  480. package/test/dns-transport.spec.ts +0 -669
  481. package/test/dns.spec.ts +0 -118
  482. package/test/dnssec-analysis.spec.ts +0 -48
  483. package/test/env.d.ts +0 -3
  484. package/test/explain-finding.spec.ts +0 -578
  485. package/test/format-report.spec.ts +0 -273
  486. package/test/format-scan-report.spec.ts +0 -160
  487. package/test/freemium-limits.spec.ts +0 -102
  488. package/test/freemium-model.spec.ts +0 -143
  489. package/test/fuzzing-alert-dedup.test.ts +0 -82
  490. package/test/fuzzing-counter.integration.test.ts +0 -75
  491. package/test/fuzzing-detector.test.ts +0 -87
  492. package/test/fuzzing-e2e.integration.test.ts +0 -114
  493. package/test/generate-discovery-report.spec.ts +0 -337
  494. package/test/generate-fix-plan.spec.ts +0 -219
  495. package/test/generate-records.spec.ts +0 -241
  496. package/test/generate-rollout-plan.spec.ts +0 -261
  497. package/test/handlers-prompts.spec.ts +0 -96
  498. package/test/handlers-resources.spec.ts +0 -85
  499. package/test/handlers-tools.spec.ts +0 -1042
  500. package/test/helpers/dns-mock.ts +0 -155
  501. package/test/http-security-analysis.spec.ts +0 -242
  502. package/test/index.spec.ts +0 -1721
  503. package/test/intelligence.spec.ts +0 -217
  504. package/test/internal-guard.spec.ts +0 -34
  505. package/test/internal-tools-analytics-auth.test.ts +0 -102
  506. package/test/internal-tools-call-body-limit.test.ts +0 -45
  507. package/test/internal-trial-keys-auth.spec.ts +0 -99
  508. package/test/internal.spec.ts +0 -411
  509. package/test/ip-utils.spec.ts +0 -127
  510. package/test/kv-fallback-logging.spec.ts +0 -220
  511. package/test/legacy-session-validation.spec.ts +0 -113
  512. package/test/legacy-sse.spec.ts +0 -140
  513. package/test/log-cf-ip-redaction.test.ts +0 -30
  514. package/test/log.spec.ts +0 -189
  515. package/test/lookalike-analysis.spec.ts +0 -67
  516. package/test/map-compliance.spec.ts +0 -284
  517. package/test/map-supply-chain.spec.ts +0 -584
  518. package/test/maturity-staging.spec.ts +0 -312
  519. package/test/mcp-dispatch.spec.ts +0 -123
  520. package/test/mcp-execute.spec.ts +0 -1259
  521. package/test/mcp-request.spec.ts +0 -115
  522. package/test/mcp-route-gates.spec.ts +0 -88
  523. package/test/mta-sts-analysis.spec.ts +0 -74
  524. package/test/mx-analysis.spec.ts +0 -32
  525. package/test/mx-reputation-analysis.spec.ts +0 -116
  526. package/test/ns-analysis.spec.ts +0 -49
  527. package/test/oauth/authorize-get.spec.ts +0 -170
  528. package/test/oauth/authorize-post.spec.ts +0 -286
  529. package/test/oauth/authorize-zod-leak.test.ts +0 -40
  530. package/test/oauth/bearer-jwt.spec.ts +0 -152
  531. package/test/oauth/discovery.spec.ts +0 -51
  532. package/test/oauth/e2e.spec.ts +0 -141
  533. package/test/oauth/entitlements.spec.ts +0 -110
  534. package/test/oauth/internal-grant.spec.ts +0 -183
  535. package/test/oauth/jwt.spec.ts +0 -91
  536. package/test/oauth/pkce.spec.ts +0 -57
  537. package/test/oauth/register.spec.ts +0 -79
  538. package/test/oauth/storage.spec.ts +0 -74
  539. package/test/oauth/token.spec.ts +0 -270
  540. package/test/output-sanitize.spec.ts +0 -450
  541. package/test/package-api.spec.ts +0 -35
  542. package/test/profile-accumulator.spec.ts +0 -567
  543. package/test/provider-guides.spec.ts +0 -74
  544. package/test/provider-signature-source.spec.ts +0 -68
  545. package/test/provider-signatures.spec.ts +0 -112
  546. package/test/public-suffix.spec.ts +0 -197
  547. package/test/queue-consumer-analytics.spec.ts +0 -65
  548. package/test/quota-coordinator.spec.ts +0 -74
  549. package/test/rate-limit-chaos.spec.ts +0 -529
  550. package/test/rate-limiter-kv-reset.test.ts +0 -62
  551. package/test/rate-limiter-memory.spec.ts +0 -31
  552. package/test/rate-limiter-ttl.spec.ts +0 -100
  553. package/test/rate-limiter.spec.ts +0 -491
  554. package/test/resolve-spf-chain.spec.ts +0 -183
  555. package/test/safe-fetch.test.ts +0 -45
  556. package/test/sanitize.spec.ts +0 -233
  557. package/test/scan-domain-cache-status.test.ts +0 -128
  558. package/test/scan-domain-provider-inference.spec.ts +0 -93
  559. package/test/scan-domain-safe-check.spec.ts +0 -91
  560. package/test/scan-domain.spec.ts +0 -1063
  561. package/test/scan-post-processing.spec.ts +0 -663
  562. package/test/scheduled.spec.ts +0 -104
  563. package/test/schemas/audit.test.ts +0 -140
  564. package/test/schemas/auth.spec.ts +0 -36
  565. package/test/schemas/dns.spec.ts +0 -48
  566. package/test/schemas/internal.spec.ts +0 -50
  567. package/test/schemas/json-rpc.spec.ts +0 -63
  568. package/test/schemas/oauth.spec.ts +0 -104
  569. package/test/schemas/primitives.spec.ts +0 -131
  570. package/test/schemas/session.spec.ts +0 -21
  571. package/test/schemas/tenant-alerts.test.ts +0 -126
  572. package/test/schemas/tenant-internal.test.ts +0 -128
  573. package/test/schemas/tool-args.spec.ts +0 -166
  574. package/test/schemas/tool-definitions.spec.ts +0 -67
  575. package/test/scoring-config-cached.spec.ts +0 -63
  576. package/test/scoring-config.spec.ts +0 -177
  577. package/test/scoring-determinism.spec.ts +0 -162
  578. package/test/scoring-engine.spec.ts +0 -134
  579. package/test/scoring-model.spec.ts +0 -44
  580. package/test/scoring-profiles.spec.ts +0 -235
  581. package/test/scoring.spec.ts +0 -197
  582. package/test/security-hardening.spec.ts +0 -58
  583. package/test/session-degradation-event.spec.ts +0 -66
  584. package/test/session-keepalive.spec.ts +0 -347
  585. package/test/session-kv-failure-logging.spec.ts +0 -99
  586. package/test/session-memory.spec.ts +0 -111
  587. package/test/session-recovery.spec.ts +0 -260
  588. package/test/session.spec.ts +0 -266
  589. package/test/simulate-attack-paths.spec.ts +0 -888
  590. package/test/spf-analysis.spec.ts +0 -29
  591. package/test/spf-trust-surface.spec.ts +0 -62
  592. package/test/srv-analysis.spec.ts +0 -151
  593. package/test/sse.spec.ts +0 -44
  594. package/test/ssl-analysis.spec.ts +0 -27
  595. package/test/stdio.spec.ts +0 -71
  596. package/test/streaming-sse.spec.ts +0 -419
  597. package/test/subdomain-takeover-analysis.spec.ts +0 -104
  598. package/test/tenants/alerts/diff.test.ts +0 -127
  599. package/test/tenants/alerts/webhook.test.ts +0 -129
  600. package/test/tenants/audit.test.ts +0 -220
  601. package/test/tenants/cron.integration.test.ts +0 -117
  602. package/test/tenants/db/registry-schema.spec.ts +0 -254
  603. package/test/tenants/db/tenant-schema.spec.ts +0 -202
  604. package/test/tenants/discovery/dkim-key-reuse.test.ts +0 -213
  605. package/test/tenants/discovery/dmarc-rua-miner.test.ts +0 -179
  606. package/test/tenants/discovery/ns-correlator.test.ts +0 -186
  607. package/test/tenants/discovery/san-correlator.test.ts +0 -128
  608. package/test/tenants/discovery-route.integration.test.ts +0 -135
  609. package/test/tenants/dns-fingerprint.test.ts +0 -321
  610. package/test/tenants/hammer-stress.integration.test.ts +0 -136
  611. package/test/tenants/per-tenant-rate-limit.test.ts +0 -119
  612. package/test/tenants/phase6-fingerprint.integration.test.ts +0 -147
  613. package/test/tenants/provision-tenant.test.ts +0 -351
  614. package/test/tenants/queue-consumer.integration.test.ts +0 -355
  615. package/test/tenants/queue-producer.integration.test.ts +0 -219
  616. package/test/tenants/routes.integration.test.ts +0 -783
  617. package/test/tenants/scheduled-handlers.integration.test.ts +0 -713
  618. package/test/tenants/tenant-d1.spec.ts +0 -78
  619. package/test/tenants/tenant-kv.spec.ts +0 -104
  620. package/test/tenants/tenant-r2.spec.ts +0 -103
  621. package/test/tier-auth-jwt-enum.test.ts +0 -55
  622. package/test/tier-auth-owner-jwt-ip.test.ts +0 -80
  623. package/test/tier-auth.spec.ts +0 -191
  624. package/test/tool-args.spec.ts +0 -101
  625. package/test/tool-execution.spec.ts +0 -421
  626. package/test/tool-formatters.spec.ts +0 -84
  627. package/test/tool-metadata.spec.ts +0 -25
  628. package/test/tool-schemas.spec.ts +0 -113
  629. package/test/trial-keys.spec.ts +0 -367
  630. package/test/tsconfig.json +0 -8
  631. package/test/txt-hygiene-analysis.spec.ts +0 -118
  632. package/test/validate-fix.spec.ts +0 -71
  633. package/test/validate-outbound-url.test.ts +0 -63
  634. package/test/wasm-integration.test.ts +0 -32
  635. package/test/zone-hygiene-analysis.spec.ts +0 -172
  636. package/tsconfig.json +0 -40
  637. package/tsup.config.ts +0 -42
  638. package/vitest.config.mts +0 -33
  639. package/wrangler.jsonc +0 -70
  640. 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