@yagyeshvyas/vibeguard 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (52) hide show
  1. package/README.md +600 -0
  2. package/bin/cli.js +1640 -0
  3. package/ci/vibeguard.yml +41 -0
  4. package/ci-templates/Jenkinsfile +26 -0
  5. package/ci-templates/azure-pipelines.yml +29 -0
  6. package/ci-templates/circleci.yml +24 -0
  7. package/ci-templates/gitlab.yml +19 -0
  8. package/hooks/pre-commit +31 -0
  9. package/package.json +94 -0
  10. package/src/ai-guard.js +205 -0
  11. package/src/ast.js +319 -0
  12. package/src/audit-trail.js +154 -0
  13. package/src/autofix.js +524 -0
  14. package/src/badge.js +42 -0
  15. package/src/behavior.js +205 -0
  16. package/src/compliance.js +151 -0
  17. package/src/crosstaint.js +324 -0
  18. package/src/cve-intel.js +136 -0
  19. package/src/dashboard.js +279 -0
  20. package/src/deps.js +159 -0
  21. package/src/doctor.js +111 -0
  22. package/src/engine.js +234 -0
  23. package/src/external.js +160 -0
  24. package/src/firewall.js +517 -0
  25. package/src/history.js +87 -0
  26. package/src/hook.js +151 -0
  27. package/src/install.js +248 -0
  28. package/src/interceptor.js +476 -0
  29. package/src/mcp-server.js +1804 -0
  30. package/src/net-audit.js +208 -0
  31. package/src/pii.js +212 -0
  32. package/src/plugin.js +80 -0
  33. package/src/policy-gen.js +288 -0
  34. package/src/pre-deploy.js +282 -0
  35. package/src/presets.js +113 -0
  36. package/src/privacy-audit.js +273 -0
  37. package/src/repl.js +150 -0
  38. package/src/report.js +312 -0
  39. package/src/rules-pack.js +2753 -0
  40. package/src/rules.js +1446 -0
  41. package/src/sandbox.js +139 -0
  42. package/src/scanner.js +651 -0
  43. package/src/secure-prompt.js +140 -0
  44. package/src/slopsquat.js +144 -0
  45. package/src/supply-firewall.js +243 -0
  46. package/src/suppress.js +89 -0
  47. package/src/taint.js +168 -0
  48. package/src/trace.js +220 -0
  49. package/src/urlscan.js +142 -0
  50. package/src/vault.js +145 -0
  51. package/src/verify.js +98 -0
  52. package/src/verifykeys.js +87 -0
package/README.md ADDED
@@ -0,0 +1,600 @@
1
+ <div align="center">
2
+
3
+ <!-- Animated Banner -->
4
+ <img src="https://readme-typing-svg.herokuapp.com?font=Fira+Code&weight=600&size=28&pause=1000&color=2E75B6&center=true&vCenter=true&random=false&width=600&lines=VibeGuard;Security+%26+Privacy+for+AI-Coded+Apps;699+Rules+%7C+76+MCP+Tools;13+Defense+Layers;Zero+Telemetry+%7C+%240+Cost" alt="VibeGuard Animated Banner" />
5
+
6
+ <br/>
7
+
8
+ <!-- Badges -->
9
+ ![GitHub stars](https://img.shields.io/github/stars/yagyeshVyas/VibeGuard?style=for-the-badge&color=2E75B6)
10
+ ![GitHub forks](https://img.shields.io/github/forks/yagyeshVyas/VibeGuard?style=for-the-badge&color=2E75B6)
11
+ ![GitHub license](https://img.shields.io/github/license/yagyeshVyas/VibeGuard?style=for-the-badge&color=22C55E)
12
+ ![GitHub issues](https://img.shields.io/github/issues/yagyeshVyas/VibeGuard?style=for-the-badge&color=F59E0B)
13
+ ![GitHub last commit](https://img.shields.io/github/last-commit/yagyeshVyas/VibeGuard?style=for-the-badge&color=2E75B6)
14
+ ![npm](https://img.shields.io/badge/npm-vibeguard-blue?style=for-the-badge&color=CB3837)
15
+ ![rules](https://img.shields.io/badge/rules-699-blue?style=for-the-badge&color=2E75B6)
16
+ ![MCP tools](https://img.shields.io/badge/MCP%20tools-76-blue?style=for-the-badge&color=8B5CF6)
17
+ ![cost](https://img.shields.io/badge/cost-%240-green?style=for-the-badge&color=22C55E)
18
+ ![privacy](https://img.shields.io/badge/privacy-100%25%20local-green?style=for-the-badge&color=22C55E)
19
+ ![telemetry](https://img.shields.io/badge/telemetry-NONE-green?style=for-the-badge&color=22C55E)
20
+
21
+ <br/>
22
+
23
+ <!-- Tagline -->
24
+ <h3>The Security & Privacy Platform Built for Vibe Coders</h3>
25
+
26
+ <p>AI coding tools (Claude Code, Cursor, Windsurf, Lovable, Bolt) ship fast — and often ship hardcoded secrets, open databases, injection holes, and privacy violations. <b>VibeGuard catches all of it.</b></p>
27
+
28
+ <p><b>699 rules</b> · <b>76 MCP tools</b> · <b>58 CLI commands</b> · <b>13 defense layers</b> · <b>43 auto-fixes</b> · <b>12 AI clients</b> · <b>14 languages</b> · <b>20+ frameworks</b> · <b>$0 cost</b> · <b>zero telemetry</b></p>
29
+
30
+ <br/>
31
+
32
+ <!-- Install -->
33
+ ## 📦 Install
34
+
35
+ ### Option 1: From npm (when published)
36
+ ```bash
37
+ npx @yagyeshvyas/vibeguard install
38
+ ```
39
+
40
+ ### Option 2: From GitHub (works now!)
41
+
42
+ ```bash
43
+ git clone https://github.com/yagyeshVyas/VibeGuard.git
44
+ cd VibeGuard
45
+ npm install
46
+ npm link # makes 'vibeguard' available globally
47
+ ```
48
+
49
+ Then use it:
50
+ ```bash
51
+ vibeguard scan # scan your project
52
+ vibeguard dashboard # beautiful terminal dashboard
53
+ vibeguard fix # auto-fix 43 rule types
54
+ vibeguard pre-deploy # 13-gate deployment check
55
+ vibeguard firewall "your prompt here" # AI firewall
56
+ ```
57
+
58
+ ### Wire into Claude Code (from GitHub clone)
59
+
60
+ ```bash
61
+ # In your project directory:
62
+ echo '{ "mcpServers": { "vibeguard": { "command": "node", "args": ["/path/to/VibeGuard/bin/cli.js", "mcp"] } } }' > .mcp.json
63
+ ```
64
+
65
+ Or use the global Claude Code command:
66
+ ```bash
67
+ claude mcp add vibeguard -- node /path/to/VibeGuard/bin/cli.js mcp
68
+ ```
69
+
70
+ ### Wire into Cursor / Windsurf / other MCP clients
71
+
72
+ Add to your MCP config file:
73
+ ```json
74
+ {
75
+ "mcpServers": {
76
+ "vibeguard": {
77
+ "command": "node",
78
+ "args": ["/path/to/VibeGuard/bin/cli.js", "mcp"]
79
+ }
80
+ }
81
+ }
82
+ ```
83
+
84
+ ### Wire into Codex CLI
85
+
86
+ ```bash
87
+ # Add to ~/.codex/config.toml:
88
+ [mcp_servers.vibeguard]
89
+ command = "node"
90
+ args = ["/path/to/VibeGuard/bin/cli.js", "mcp"]
91
+ ```
92
+
93
+ <p>Auto-detects 12 AI coding clients: <b>Claude Code, Cursor, Windsurf, Codex CLI, Antigravity, Gemini CLI, Continue, Cline, Roo Code, OpenHands, Aider, VS Code</b></p>
94
+
95
+ <!-- AI Client Logos -->
96
+ <table>
97
+ <tr>
98
+ <td align="center">🔵</td>
99
+ <td align="center">🟣</td>
100
+ <td align="center">🟢</td>
101
+ <td align="center">🟡</td>
102
+ <td align="center">🔴</td>
103
+ <td align="center">🟠</td>
104
+ <td align="center">⚫</td>
105
+ </tr>
106
+ <tr>
107
+ <td align="center"><sub>Claude Code</sub></td>
108
+ <td align="center"><sub>Cursor</sub></td>
109
+ <td align="center"><sub>Windsurf</sub></td>
110
+ <td align="center"><sub>Codex CLI</sub></td>
111
+ <td align="center"><sub>Antigravity</sub></td>
112
+ <td align="center"><sub>Gemini CLI</sub></td>
113
+ <td align="center"><sub>Continue</sub></td>
114
+ </tr>
115
+ <tr>
116
+ <td align="center"><sub>Cline</sub></td>
117
+ <td align="center"><sub>Roo Code</sub></td>
118
+ <td align="center"><sub>OpenHands</sub></td>
119
+ <td align="center"><sub>Aider</sub></td>
120
+ <td align="center"><sub>VS Code</sub></td>
121
+ <td align="center"><sub>+ more</sub></td>
122
+ <td align="center"></td>
123
+ </tr>
124
+ </table>
125
+
126
+ <br/>
127
+
128
+ ```bash
129
+ vibeguard scan # scan your project
130
+ vibeguard dashboard # beautiful terminal dashboard
131
+ vibeguard fix # auto-fix 43 rule types
132
+ vibeguard pre-deploy # 13-gate deployment check
133
+ ```
134
+
135
+ </div>
136
+
137
+ ---
138
+
139
+ <!-- Table of Contents -->
140
+ <div align="center">
141
+ <h2>📖 What is VibeGuard?</h2>
142
+ </div>
143
+
144
+ VibeGuard is a **free, zero-dependency security and privacy scanner** that runs entirely on your machine. It reads your code files locally, checks them against 699 security rules, and tells you exactly what's wrong and how to fix it — all without sending a single byte to any server.
145
+
146
+ It's built specifically for the problems AI coding tools create:
147
+ - Hardcoded API keys visible in browser dev tools
148
+ - Supabase/Firebase databases open to the world (no RLS)
149
+ - Admin endpoints with no authentication
150
+ - SQL injection, command injection, XSS
151
+ - Secrets committed to git history
152
+ - Hallucinated npm packages that don't exist
153
+ - User data sent to AI APIs without redaction
154
+ - Analytics tracking without consent (GDPR violation)
155
+ - WebRTC IP leaks, clipboard theft, geolocation without consent
156
+
157
+ ---
158
+
159
+ <div align="center">
160
+ <h2>🛡️ 13-Layer Defense Architecture</h2>
161
+ </div>
162
+
163
+ Even if an AI is **fully jailbroken**, it cannot leak data. Each layer runs automatically when the MCP server starts.
164
+
165
+ <table>
166
+ <tr>
167
+ <th>#</th>
168
+ <th>Layer</th>
169
+ <th>Module</th>
170
+ <th>What It Catches</th>
171
+ <th>When</th>
172
+ </tr>
173
+ <tr>
174
+ <td align="center">1</td>
175
+ <td><b>Static Scanner</b></td>
176
+ <td><code>scanner.js</code></td>
177
+ <td>699 security rules across 14 languages</td>
178
+ <td>Before deploy</td>
179
+ </tr>
180
+ <tr>
181
+ <td align="center">2</td>
182
+ <td><b>AI Firewall</b></td>
183
+ <td><code>firewall.js</code></td>
184
+ <td>Prompt injection, jailbreaks, secret access</td>
185
+ <td>Before LLM call</td>
186
+ </tr>
187
+ <tr>
188
+ <td align="center">3</td>
189
+ <td><b>Agent Guard</b></td>
190
+ <td><code>firewall.js</code></td>
191
+ <td>Dangerous file/command/network access</td>
192
+ <td>Before agent action</td>
193
+ </tr>
194
+ <tr>
195
+ <td align="center">4</td>
196
+ <td><b>Runtime Interceptor</b></td>
197
+ <td><code>interceptor.js</code></td>
198
+ <td>Wraps fetch/http/exec/fs at runtime level</td>
199
+ <td>During execution</td>
200
+ </tr>
201
+ <tr>
202
+ <td align="center">5</td>
203
+ <td><b>Output Guard</b></td>
204
+ <td><code>interceptor.js</code></td>
205
+ <td>Secrets/PII in AI responses → redacted</td>
206
+ <td>After LLM response</td>
207
+ </tr>
208
+ <tr>
209
+ <td align="center">6</td>
210
+ <td><b>Exfil Firewall</b></td>
211
+ <td><code>firewall.js</code></td>
212
+ <td>PII/secrets in outbound data → blocked</td>
213
+ <td>Before any request</td>
214
+ </tr>
215
+ <tr>
216
+ <td align="center">7</td>
217
+ <td><b>Env Lock</b></td>
218
+ <td><code>interceptor.js</code></td>
219
+ <td>Hides sensitive env vars from AI</td>
220
+ <td>At process start</td>
221
+ </tr>
222
+ <tr>
223
+ <td align="center">8</td>
224
+ <td><b>Self-Protection</b></td>
225
+ <td><code>interceptor.js</code></td>
226
+ <td>Detects tampering with VibeGuard itself</td>
227
+ <td>Continuous</td>
228
+ </tr>
229
+ <tr>
230
+ <td align="center">9</td>
231
+ <td><b>Zero-Trust Sandbox</b></td>
232
+ <td><code>sandbox.js</code></td>
233
+ <td>Locked VM: no fs, no exec, no network</td>
234
+ <td>Code execution</td>
235
+ </tr>
236
+ <tr>
237
+ <td align="center">10</td>
238
+ <td><b>Behavioral Analysis</b></td>
239
+ <td><code>behavior.js</code></td>
240
+ <td>Trust building, data gathering, slow exfil</td>
241
+ <td>Over session</td>
242
+ </tr>
243
+ <tr>
244
+ <td align="center">11</td>
245
+ <td><b>Supply Chain Firewall</b></td>
246
+ <td><code>supply-firewall.js</code></td>
247
+ <td>Malware, typosquats, dangerous scripts</td>
248
+ <td>Before npm install</td>
249
+ </tr>
250
+ <tr>
251
+ <td align="center">12</td>
252
+ <td><b>Secret Vault</b></td>
253
+ <td><code>vault.js</code></td>
254
+ <td>AES-256-GCM encrypted in-memory storage</td>
255
+ <td>Secret access</td>
256
+ </tr>
257
+ <tr>
258
+ <td align="center">13</td>
259
+ <td><b>Audit Trail</b></td>
260
+ <td><code>audit-trail.js</code></td>
261
+ <td>SHA-256 chained tamper-proof log</td>
262
+ <td>All actions</td>
263
+ </tr>
264
+ </table>
265
+
266
+ ---
267
+
268
+ <div align="center">
269
+ <h2>🔥 What VibeGuard Catches</h2>
270
+ </div>
271
+
272
+ <details>
273
+ <summary><b>🔓 The #1 r/vibecoding Issue: Open Databases</b></summary>
274
+
275
+ If you use Supabase, Firebase, or Convex, VibeGuard checks:
276
+ - **RLS missing** — table created but row-level security never enabled
277
+ - **RLS fake policy** — `USING (true)` — looks enabled in dashboard, protects nothing
278
+ - **PERMISSIVE policy** — allows access unless another policy blocks it
279
+ - **Service role key in client** — bypasses RLS entirely
280
+ - **Firebase rules open** — `.read: true` or `.write: true`
281
+ - **Firebase rules any-auth** — `auth != null` means ANY logged-in user sees ALL data
282
+ - **Convex public query** — exported query with no auth check
283
+ </details>
284
+
285
+ <details>
286
+ <summary><b>🔑 Secrets (50+ types)</b></summary>
287
+
288
+ OpenAI, Anthropic, Stripe (live + restricted), AWS, GitHub, Slack, GitLab, Twilio, SendGrid, Mailgun, Telegram, npm, Resend, GCP, Azure, Cloudflare, Datadog, Sentry, Algolia, Vercel, Netlify, Heroku, DigitalOcean, Notion, Linear, Contentful, PlanetScale, Vault, Doppler, Grafana, Jira, PagerDuty, New Relic, Splunk, Braintree, Square, Paddle, MUX, Mailchimp, Postmark, Sendinblue, Twitch, Patreon, Discord, Bitbucket, JFrog, LaunchDarkly, Rollbar, Mapbox, Twilio SID, and more.
289
+
290
+ Plus: connection strings with passwords, `.env` not in `.gitignore`, secrets in localStorage/sessionStorage, secrets in URL params, secrets in client-side config files.
291
+ </details>
292
+
293
+ <details>
294
+ <summary><b>💉 Injection (30+ rules)</b></summary>
295
+
296
+ - **SQL injection** — string concat, template literals, f-strings, format(), % formatting, raw queries across Prisma, Drizzle, Sequelize, TypeORM, Kysely, MikroORM, Turso, Hono, Go, Python, PHP, C#, Kotlin, Rust
297
+ - **Command injection** — exec/spawn with user input, template literals, backtick interpolation
298
+ - **Code injection** — eval, new Function, setTimeout/setInterval with strings, vm.runInContext
299
+ - **XSS** — dangerouslySetInnerHTML, v-html, innerHTML, outerHTML, document.write, insertAdjacentHTML, Angular DomSanitizer bypass, Rails html_safe, Laravel `{!! !!}`
300
+ - **SSTI** — template render with user input (EJS, Pug, Handlebars, Mustache)
301
+ - **LDAP, XPath, NoSQL $where, header injection, log injection, CSV formula injection, PDF injection**
302
+ - **SSRF** — fetch to internal IPs, cloud metadata service (169.254.169.254), DNS rebinding
303
+ </details>
304
+
305
+ <details>
306
+ <summary><b>🔐 Auth (20+ rules)</b></summary>
307
+
308
+ - JWT alg:none, weak JWT secret, JWT decoded without verify
309
+ - Hardcoded admin credentials
310
+ - Password compared with `==` (plaintext)
311
+ - Session fixation (no regenerate after login)
312
+ - No rate limiting on login/register
313
+ - Password in query string
314
+ - Missing MFA enforcement
315
+ - OAuth state parameter empty/static
316
+ - Token in URL
317
+ - No logout endpoint
318
+ </details>
319
+
320
+ <details>
321
+ <summary><b>🤖 AI/LLM Security (35+ rules)</b></summary>
322
+
323
+ - Prompt injection in tool descriptions
324
+ - AI agent can execute code, deploy, install packages, access secrets, modify auth
325
+ - LLM output used as SQL, shell, DOM, file path
326
+ - Data exfiltration via agent
327
+ - Memory poisoning
328
+ - Training data leakage
329
+ - Agent loop without iteration cap
330
+ - Tool result injection
331
+ - Missing max_tokens, temperature too high
332
+ - Browser API key exposure
333
+ - **Secure prompt analysis** — analyzes your prompt BEFORE code generation
334
+ </details>
335
+
336
+ <details>
337
+ <summary><b>📦 Supply Chain (15+ rules)</b></summary>
338
+
339
+ - **Slopsquat detection** — hallucinated npm packages that don't exist
340
+ - Typosquat detection
341
+ - Postinstall scripts with curl/wget/eval
342
+ - Unpinned Docker images (:latest)
343
+ - GPL/AGPL license risk
344
+ - Missing integrity hashes
345
+ - git+http dependencies
346
+ - Crypto miners in dependencies
347
+ - Missing .npmrc
348
+ </details>
349
+
350
+ <details>
351
+ <summary><b>🏗️ Infrastructure (40+ rules)</b></summary>
352
+
353
+ - **Terraform**: S3 public, IAM wildcard, SG 0.0.0.0/0, RDS public, no encryption, no KMS rotation, hardcoded keys, no backup, no CloudTrail
354
+ - **Kubernetes**: run-as-root, no readOnly FS, hostPath, hostPID/IPC, no NetworkPolicy, privileged, SYS_ADMIN, no seccomp, no probes, no security context
355
+ - **Docker**: no USER directive, no HEALTHCHECK, privileged, no resource limits, secrets in env, :latest
356
+ - **Docker Compose**: no resource limits, secrets in environment, privileged, host network, weak restart policy
357
+ - **GitHub Actions**: script injection, write-all permissions, unpinned actions
358
+ - **CI/CD**: GitLab secrets in YAML, Jenkins credentials, CircleCI context, AWS CDK secrets, CloudFormation, Helm, Ansible, Pulumi
359
+ </details>
360
+
361
+ <details>
362
+ <summary><b>🔒 Privacy Protection (50+ rules)</b></summary>
363
+
364
+ VibeGuard is the only scanner that protects user **privacy**, not just security:
365
+ - WebRTC IP leak, clipboard reads, geolocation, camera/microphone
366
+ - Canvas fingerprinting, device fingerprinting, Bluetooth scanning
367
+ - Analytics without consent (Google Analytics, Mixpanel, Segment, PostHog, Amplitude, Facebook Pixel, Hotjar, FullStory)
368
+ - Cookies without banner (ePrivacy/GDPR)
369
+ - Sentry with PII, PII in logs, health data access, biometric data
370
+ - Background location, contacts/photos/SMS/call log access
371
+ - EXIF location leak, keystroke listeners, SRI missing
372
+ </details>
373
+
374
+ ---
375
+
376
+ <div align="center">
377
+ <h2>⚡ Privacy Commands</h2>
378
+ </div>
379
+
380
+ ```bash
381
+ vibeguard privacy-audit # inventory all PII collection, storage, transmission
382
+ vibeguard net-audit # map every outbound HTTP call (where does data go?)
383
+ vibeguard ai-guard # detect user data sent to AI APIs without redaction
384
+ vibeguard privacy-policy # auto-generate a privacy policy from code analysis
385
+ vibeguard csp-generate # auto-generate Content-Security-Policy from code
386
+ vibeguard firewall <prompt> # AI firewall — inspect prompt before sending to LLM
387
+ vibeguard agent-guard # show blocked paths, commands, domains
388
+ vibeguard exfil-check <data> # check data for PII/secrets before sending externally
389
+ vibeguard dep-firewall <pkg> # check package name before npm install
390
+ vibeguard sandbox <code> # execute code in zero-trust sandbox
391
+ vibeguard output-guard <text> # sanitize AI response for secrets/PII
392
+ vibeguard env-lock # lock environment variables — hide secrets from AI
393
+ vibeguard self-check # verify VibeGuard hasn't been tampered with
394
+ vibeguard pre-deploy # run all 13 security gates before deployment
395
+ ```
396
+
397
+ ### PII Detection & Redaction
398
+
399
+ ```js
400
+ const { detectPII, redactText } = require('vibeguard/pii');
401
+
402
+ const text = 'Contact john@example.com or 555-123-4567. Card: 4242424242424242';
403
+ const detected = detectPII(text); // [{ type: 'email', ... }, { type: 'credit-card', ... }]
404
+ const safe = redactText(text); // 'Contact [REDACTED_EMAIL] or [REDACTED_PHONE]. Card: ****4242'
405
+ ```
406
+
407
+ Detected types: email, phone, SSN, credit card (Luhn-validated), AWS keys, JWTs, private keys, IP addresses, IBANs, MAC addresses.
408
+
409
+ ---
410
+
411
+ <div align="center">
412
+ <h2>🚀 Pre-Deploy Gate (13 Gates)</h2>
413
+ </div>
414
+
415
+ Run all 13 security gates before deployment. If ANY gate fails, deployment is blocked.
416
+
417
+ ```bash
418
+ vibeguard pre-deploy # run all gates
419
+ vibeguard pre-deploy --strict # fail on warnings too
420
+ vibeguard pre-deploy --json # JSON output for CI/CD
421
+ ```
422
+
423
+ | # | Gate | What It Checks |
424
+ |---|------|------|
425
+ | 1 | Static Scan | 699 rules — any critical? |
426
+ | 2 | Secret Scan | Secrets exposed in code? |
427
+ | 3 | Git History | .env tracked in git? |
428
+ | 4 | Dependency Audit | Slopsquat/typosquat? |
429
+ | 5 | Supply Chain | Lockfile, scripts, licenses? |
430
+ | 6 | Privacy Audit | PII collection/storage/transmission? |
431
+ | 7 | Network Audit | Suspicious outbound domains? |
432
+ | 8 | AI Data Guard | User data to AI APIs without redaction? |
433
+ | 9 | Compliance | SOC2/PCI/HIPAA/GDPR? |
434
+ | 10 | Config Check | .env in .gitignore? MCP installed? |
435
+ | 11 | Self-Check | All VibeGuard modules intact? |
436
+ | 12 | Tamper Check | No tampering with VibeGuard? |
437
+ | 13 | Behavioral Check | No suspicious patterns? |
438
+
439
+ ---
440
+
441
+ <div align="center">
442
+ <h2>📊 Numbers</h2>
443
+ </div>
444
+
445
+ <table>
446
+ <tr><th>Metric</th><th>Value</th><th></th></tr>
447
+ <tr><td>Rules</td><td><b>699</b></td><td>🔒</td></tr>
448
+ <tr><td>MCP tools</td><td><b>76</b></td><td>🤖</td></tr>
449
+ <tr><td>CLI commands</td><td><b>58</b></td><td>💻</td></tr>
450
+ <tr><td>Auto-fixable rules</td><td><b>43</b></td><td>🔧</td></tr>
451
+ <tr><td>Defense layers</td><td><b>13</b></td><td>🛡️</td></tr>
452
+ <tr><td>Pre-deploy gates</td><td><b>13</b></td><td>🚀</td></tr>
453
+ <tr><td>AI clients</td><td><b>12</b></td><td>🧠</td></tr>
454
+ <tr><td>Languages</td><td><b>14</b></td><td>🌐</td></tr>
455
+ <tr><td>Frameworks</td><td><b>20+</b></td><td>⚡</td></tr>
456
+ <tr><td>Presets</td><td><b>12</b></td><td>⚙️</td></tr>
457
+ <tr><td>Privacy rules</td><td><b>50+</b></td><td>🔒</td></tr>
458
+ <tr><td>Firewall rules</td><td><b>30+</b></td><td>🔥</td></tr>
459
+ <tr><td>AI Firewall threats</td><td><b>20+</b></td><td>🧱</td></tr>
460
+ <tr><td>PII types detected</td><td><b>10+</b></td><td>👁️</td></tr>
461
+ <tr><td>Source modules</td><td><b>43</b></td><td>📦</td></tr>
462
+ <tr><td>Tests</td><td><b>236</b></td><td>✅</td></tr>
463
+ <tr><td>Lint errors</td><td><b>0</b></td><td>✨</td></tr>
464
+ <tr><td>Dependencies</td><td><b>1</b> (MCP SDK)</td><td>📦</td></tr>
465
+ <tr><td>Cost</td><td><b>$0</b></td><td>💚</td></tr>
466
+ <tr><td>Telemetry</td><td><b>None</b></td><td>🔒</td></tr>
467
+ <tr><td>Data sent to servers</td><td><b>None</b></td><td>🔒</td></tr>
468
+ </table>
469
+
470
+ ---
471
+
472
+ <div align="center">
473
+ <h2>🔒 Privacy Guarantee</h2>
474
+ </div>
475
+
476
+ **VibeGuard never sends your code, secrets, API keys, or personal information anywhere.**
477
+
478
+ | What | Network? | When |
479
+ |------|----------|------|
480
+ | `vibeguard scan` | **Never** | Local file read + regex match |
481
+ | `vibeguard fix` | **Never** | Local file edit |
482
+ | `vibeguard install` | **Never** | Local config write |
483
+ | `vibeguard mcp` | **Never** | stdio transport only |
484
+ | `vibeguard cve` | Opt-in | Package name → OSV.dev (free API) |
485
+ | `vibeguard url` | Opt-in | URL you type → fetch headers |
486
+ | `--verify-keys` | Opt-in | Key → provider that owns it |
487
+
488
+ **No telemetry. No analytics. No tracking. No data collection. No uploads.**
489
+
490
+ ---
491
+
492
+ <div align="center">
493
+ <h2>⚙️ Presets</h2>
494
+ </div>
495
+
496
+ ```bash
497
+ vibeguard preset nextjs # Next.js + React
498
+ vibeguard preset django # Django + Python
499
+ vibeguard preset rails # Ruby on Rails
500
+ vibeguard preset spring # Spring Boot + Java
501
+ vibeguard preset aws # AWS / Terraform
502
+ vibeguard preset gcp # Google Cloud
503
+ vibeguard preset azure # Azure
504
+ vibeguard preset api # REST / GraphQL API
505
+ vibeguard preset mobile # React Native / mobile
506
+ vibeguard preset fullstack # all rules (maximum coverage)
507
+ ```
508
+
509
+ ---
510
+
511
+ <div align="center">
512
+ <h2>🔧 CI/CD</h2>
513
+ </div>
514
+
515
+ ```bash
516
+ vibeguard init-ci # GitHub Actions (SARIF + fail on CRITICAL)
517
+ vibeguard install-hook # git pre-commit hook (blocks on critical)
518
+ vibeguard install-hook-post # PostToolUse hook (auto-scan after AI edits)
519
+ vibeguard pr-comment # GitHub PR comment format (markdown)
520
+ ```
521
+
522
+ Templates included for: **GitLab CI**, **Jenkins**, **CircleCI**, **Azure Pipelines**.
523
+
524
+ ---
525
+
526
+ <div align="center">
527
+ <h2>💻 Languages & Frameworks</h2>
528
+ </div>
529
+
530
+ **Languages (14):** JavaScript, TypeScript, Python, Go, Java, Ruby, PHP, C#, Rust, Kotlin, Swift, Bash, SQL, YAML
531
+
532
+ **Frameworks (20+):** Next.js, React, Remix, Astro, SolidStart, SvelteKit, Nuxt, Django, Flask, Rails, Laravel, Spring Boot, NestJS, Fastify, Express, Hono, tRPC, Gin, Echo, Drizzle, Prisma, Sequelize, TypeORM, Kysely, MikroORM, Convex, Turso, Clerk, Auth.js, Supabase, Firebase, Stripe, Polar, LemonSqueezy, Resend, Upstash, Pinecone, PostHog, Uploadthing
533
+
534
+ **Compliance:** SOC 2, PCI-DSS, HIPAA, GDPR, ISO 27001, EU AI Act
535
+
536
+ ---
537
+
538
+ <div align="center">
539
+ <h2>🛠️ Development</h2>
540
+ </div>
541
+
542
+ ```bash
543
+ npm install
544
+ npm test # 236 tests
545
+ npm run lint # 0 errors
546
+ npm run coverage # coverage report
547
+ ```
548
+
549
+ ---
550
+
551
+ <div align="center">
552
+ <h2>📖 Honest Scope</h2>
553
+ </div>
554
+
555
+ VibeGuard catches the **mechanical** security holes that AI tools leave behind. It does NOT:
556
+ - Prove your app is safe or leak-proof
557
+ - Track personal data end-to-end through your app automatically
558
+ - Judge business logic flaws
559
+ - Replace a real security review for anything touching money, auth, or personal data
560
+
561
+ It **raises the floor fast** — catching the holes that AI tools create by default.
562
+
563
+ ---
564
+
565
+ <div align="center">
566
+ <h2>📄 License</h2>
567
+
568
+ MIT — Free forever. No ads. No tracking. No data collection.
569
+
570
+ </div>
571
+
572
+ ---
573
+
574
+ <div align="center">
575
+
576
+ <!-- Author Section -->
577
+ <img src="https://readme-typing-svg.herokuapp.com?font=Fira+Code&weight=600&size=22&pause=1000&color=2E75B6&center=true&vCenter=true&random=false&width=400&lines=Made+with+%E2%9D%A4%EF%B8%8F+by;Yagyesh+Vyas" alt="Made by Yagyesh Vyas" />
578
+
579
+ <br/>
580
+
581
+ <a href="https://www.linkedin.com/in/yagyeshvyas/">
582
+ <img src="https://img.shields.io/badge/LinkedIn-0077B5?style=for-the-badge&logo=linkedin&logoColor=white" alt="LinkedIn" />
583
+ </a>
584
+ <a href="https://github.com/yagyeshVyas">
585
+ <img src="https://img.shields.io/badge/GitHub-100000?style=for-the-badge&logo=github&logoColor=white" alt="GitHub" />
586
+ </a>
587
+
588
+ <br/>
589
+ <br/>
590
+
591
+ <p><b>⭐ If VibeGuard helped you, star the repo!</b></p>
592
+
593
+ <p>Found a bug? <a href="https://github.com/yagyeshVyas/VibeGuard/issues">Open an issue</a></p>
594
+ <p>Want to contribute? <a href="https://github.com/yagyeshVyas/VibeGuard/pulls">Submit a PR</a></p>
595
+
596
+ <br/>
597
+
598
+ <p><sub>VibeGuard v0.1.0 · MIT License · 699 rules · 76 MCP tools · 13 defense layers · $0 cost · zero telemetry</sub></p>
599
+
600
+ </div>