@yagyeshvyas/vibeguard 1.12.0 → 1.13.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 (113) hide show
  1. package/CHANGELOG.md +26 -0
  2. package/README.md +34 -17
  3. package/bin/cli.js +2753 -2753
  4. package/bin/cmd-mcp-firewall.js +1 -0
  5. package/bin/cmd-platform.js +3 -0
  6. package/ci/vibeguard.yml +42 -42
  7. package/package.json +2 -2
  8. package/scripts/counts.js +93 -93
  9. package/scripts/postinstall.js +26 -26
  10. package/src/auto.js +427 -427
  11. package/src/daemon.js +343 -343
  12. package/src/dashboard.js +278 -278
  13. package/src/engine.js +297 -297
  14. package/src/hook.js +151 -151
  15. package/src/install.js +298 -298
  16. package/src/integrity.js +1 -0
  17. package/src/integrity.json +9 -6
  18. package/src/mcp-firewall.js +11 -0
  19. package/src/platform/approval-service.js +124 -0
  20. package/src/platform/approval.js +16 -0
  21. package/src/platform/oauth-server.js +89 -0
  22. package/src/platform/os-sandbox.js +52 -1
  23. package/src/platform/runtime-monitor.js +69 -0
  24. package/src/platform/sandbox-manager.js +5 -0
  25. package/src/plugin.js +182 -182
  26. package/src/privacy-audit.js +272 -272
  27. package/src/repl.js +150 -150
  28. package/src/report.js +331 -331
  29. package/src/rules-pack.js +3068 -3068
  30. package/src/rules.js +1822 -1822
  31. package/src/sbom.js +193 -193
  32. package/src/scanner.js +1032 -1032
  33. package/src/shell-guard.js +302 -302
  34. package/src/slopsquat.js +144 -144
  35. package/src/trace.js +220 -220
  36. package/src/.vibeguard/cache/file-hashes.json +0 -60
  37. package/src/.vibeguard/latest-snapshot.json +0 -36
  38. package/src/.vibeguard/mcp-pins.json +0 -1
  39. package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/auto.js +0 -428
  40. package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/daemon.js +0 -344
  41. package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/dashboard.js +0 -279
  42. package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/engine.js +0 -297
  43. package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/hook.js +0 -151
  44. package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/install.js +0 -299
  45. package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/manifest.json +0 -65
  46. package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/mcp-server.js +0 -2051
  47. package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/plugin.js +0 -168
  48. package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/pre-deploy.js +0 -362
  49. package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/repl.js +0 -150
  50. package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/rules.js +0 -1611
  51. package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/sbom.js +0 -164
  52. package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/shell-guard.js +0 -292
  53. package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/slopsquat.js +0 -144
  54. package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/trace.js +0 -220
  55. package/src/.vibeguard/snapshots/2026-08-05T16-26-26-074Z/auto.js +0 -428
  56. package/src/.vibeguard/snapshots/2026-08-05T16-26-26-074Z/daemon.js +0 -344
  57. package/src/.vibeguard/snapshots/2026-08-05T16-26-26-074Z/engine.js +0 -297
  58. package/src/.vibeguard/snapshots/2026-08-05T16-26-26-074Z/install.js +0 -299
  59. package/src/.vibeguard/snapshots/2026-08-05T16-26-26-074Z/manifest.json +0 -37
  60. package/src/.vibeguard/snapshots/2026-08-05T16-26-26-074Z/mcp-server.js +0 -2055
  61. package/src/.vibeguard/snapshots/2026-08-05T16-26-26-074Z/plugin.js +0 -168
  62. package/src/.vibeguard/snapshots/2026-08-05T16-26-26-074Z/pre-deploy.js +0 -362
  63. package/src/.vibeguard/snapshots/2026-08-05T16-26-26-074Z/trace.js +0 -220
  64. package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/auto.js +0 -428
  65. package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/daemon.js +0 -344
  66. package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/dashboard.js +0 -279
  67. package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/engine.js +0 -297
  68. package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/hook.js +0 -151
  69. package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/install.js +0 -299
  70. package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/manifest.json +0 -65
  71. package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/mcp-server.js +0 -2055
  72. package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/plugin.js +0 -168
  73. package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/pre-deploy.js +0 -362
  74. package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/repl.js +0 -150
  75. package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/rules.js +0 -1611
  76. package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/sbom.js +0 -164
  77. package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/shell-guard.js +0 -292
  78. package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/slopsquat.js +0 -144
  79. package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/trace.js +0 -220
  80. package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/auto.js +0 -428
  81. package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/daemon.js +0 -344
  82. package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/dashboard.js +0 -279
  83. package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/engine.js +0 -297
  84. package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/hook.js +0 -151
  85. package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/install.js +0 -299
  86. package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/manifest.json +0 -65
  87. package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/mcp-server.js +0 -2054
  88. package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/plugin.js +0 -168
  89. package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/pre-deploy.js +0 -362
  90. package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/repl.js +0 -150
  91. package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/rules.js +0 -1611
  92. package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/sbom.js +0 -164
  93. package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/shell-guard.js +0 -292
  94. package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/slopsquat.js +0 -144
  95. package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/trace.js +0 -220
  96. package/src/.vibeguard/snapshots/2026-08-05T18-11-32-644Z/auto.js +0 -428
  97. package/src/.vibeguard/snapshots/2026-08-05T18-11-32-644Z/daemon.js +0 -344
  98. package/src/.vibeguard/snapshots/2026-08-05T18-11-32-644Z/engine.js +0 -297
  99. package/src/.vibeguard/snapshots/2026-08-05T18-11-32-644Z/install.js +0 -299
  100. package/src/.vibeguard/snapshots/2026-08-05T18-11-32-644Z/manifest.json +0 -37
  101. package/src/.vibeguard/snapshots/2026-08-05T18-11-32-644Z/mcp-server.js +0 -2055
  102. package/src/.vibeguard/snapshots/2026-08-05T18-11-32-644Z/plugin.js +0 -168
  103. package/src/.vibeguard/snapshots/2026-08-05T18-11-32-644Z/pre-deploy.js +0 -362
  104. package/src/.vibeguard/snapshots/2026-08-05T18-11-32-644Z/trace.js +0 -220
  105. package/src/.vibeguard/snapshots/2026-08-05T18-16-47-635Z/auto.js +0 -428
  106. package/src/.vibeguard/snapshots/2026-08-05T18-16-47-635Z/daemon.js +0 -344
  107. package/src/.vibeguard/snapshots/2026-08-05T18-16-47-635Z/engine.js +0 -297
  108. package/src/.vibeguard/snapshots/2026-08-05T18-16-47-635Z/manifest.json +0 -33
  109. package/src/.vibeguard/snapshots/2026-08-05T18-16-47-635Z/mcp-server.js +0 -2055
  110. package/src/.vibeguard/snapshots/2026-08-05T18-16-47-635Z/rules.js +0 -1611
  111. package/src/.vibeguard/snapshots/2026-08-05T18-16-47-635Z/shell-guard.js +0 -292
  112. package/src/.vibeguard/snapshots/2026-08-05T18-16-47-635Z/trace.js +0 -220
  113. package/src/.vibeguard-baseline.json +0 -5226
package/CHANGELOG.md CHANGED
@@ -3,6 +3,32 @@
3
3
  All notable changes to VibeGuard are documented here.
4
4
  Format based on [Keep a Changelog](https://keepachangelog.com/).
5
5
 
6
+ ## [1.13.1] - 2026-11-22
7
+
8
+ ### Changed
9
+
10
+ - README tagline and banner no longer claim firewall-level enforcement; they describe the scanner and link the independent run.
11
+ - README Benchmark section now links an independent/third-party test result.
12
+
13
+ ### Added
14
+
15
+ - `test/third-party-benchmark.md` with raw human and SARIF output from an OWASP Juice Shop scan, including its false positives and stated limits.
16
+
17
+ ## [1.13.0] - 2026-11-22
18
+
19
+ ### Added
20
+
21
+ - Linux bubblewrap filesystem/network/PID isolation and Windows Job Object containment (AppContainer/WFP still absent).
22
+ - macOS `sandbox-exec` backend (deprecated profile; not App Sandbox/VM).
23
+ - Hosted approval API with authenticated tickets/proofs, JSON persistence, key rotation and read-only dashboard.
24
+ - Local OAuth 2.1 authorization-code + PKCE server with JWKS and aud/scope validation.
25
+ - Runtime RSS monitor with `--max-rss` quarantine kill.
26
+ - External audit anchor and HTTPS/mTLS bridge options.
27
+
28
+ ### Breaking
29
+
30
+ - `ApprovalBroker.decide()` requires signed approver proof by default.
31
+
6
32
  ## [1.12.0] - 2026-11-22
7
33
 
8
34
  ### Added
package/README.md CHANGED
@@ -3,12 +3,12 @@
3
3
  <picture>
4
4
  <source media="(prefers-color-scheme: dark)" srcset="website/banner.svg" />
5
5
  <source media="(prefers-color-scheme: light)" srcset="website/banner.svg" />
6
- <img src="website/banner.svg" alt="VibeGuard — security scanner + AI agent firewall" width="880" />
6
+ <img src="website/banner.svg" alt="VibeGuard — security scanner for code you didn't write" width="880" />
7
7
  </picture>
8
8
 
9
9
  <a href="https://git.io/typing-svg"><img src="https://readme-typing-svg.demolab.com?font=Fira+Code&weight=600&size=21&duration=2800&pause=900&color=22C55E&center=true&vCenter=true&width=760&lines=%24+npx+%40yagyeshvyas%2Fvibeguard+scan;861+rules+%C2%B7+93+MCP+tools+%C2%B7+18+languages;catches+what+AI+forgets+%E2%80%94+before+you+ship;offline+by+default+%C2%B7+zero+telemetry+%C2%B7+free+forever" alt="Typing animation: npx @yagyeshvyas/vibeguard scan" /></a>
10
10
 
11
- <h3>🔒 The AI-era security scanner &amp; agent firewall.</h3>
11
+ <h3>🔒 The AI-era security scanner for code you didn't write.</h3>
12
12
 
13
13
  <p>
14
14
  Scan AI-generated code for leaked keys, SQLi, prompt injection, and uncapped agent loops.<br/>
@@ -32,7 +32,7 @@ Offline by default · Zero telemetry · No paid APIs · Free forever.
32
32
  <img src="https://img.shields.io/badge/compliance-10%20frameworks-orange?style=flat-square" alt="10 compliance frameworks" />
33
33
  <img src="https://img.shields.io/badge/AI--safety%20F1-96.8%25-brightgreen?style=flat-square" alt="AI-safety F1 96.8%" />
34
34
  <img src="https://img.shields.io/badge/telemetry-zero-brightgreen?style=flat-square" alt="Zero telemetry" />
35
- <img src="https://img.shields.io/badge/tests-625%20passed-blue?style=flat-square" alt="625 tests pass" />
35
+ <img src="https://img.shields.io/badge/tests-629%20passed-blue?style=flat-square" alt="629 tests pass" />
36
36
  <img src="https://img.shields.io/badge/self--scan-Grade%20A-brightgreen?style=flat-square" alt="Self-scan Grade A" />
37
37
  </p>
38
38
 
@@ -66,7 +66,7 @@ Offline by default · Zero telemetry · No paid APIs · Free forever.
66
66
 
67
67
  ---
68
68
 
69
- ## 🆕 What's New — v1.12.0
69
+ ## 🆕 What's New — v1.13.0
70
70
 
71
71
  **Security foundation v2 (internal testing).** This release is not beta or
72
72
  production-ready; it is the verified internal-testing build described in
@@ -81,12 +81,12 @@ production-ready; it is the verified internal-testing build described in
81
81
  - Linux `unshare` network/PID namespace sandbox with `sandbox verify`.
82
82
  - Memory provenance and multi-agent delegation guards; labeled detection corpus;
83
83
  AISVS-style readiness mapping.
84
- - **625 tests, 0 failures** on Windows Node24/Node18 and Linux Node22; 31/31
84
+ - **629 tests, 0 failures** on Windows Node24/Node18 and Linux Node22; 35/35
85
85
  platform tests on Windows/Linux/macOS CI.
86
86
 
87
- Install note: v1.12.0 is distributed as `@yagyeshvyas/vibeguard@1.12.0`. If a
87
+ Install note: v1.13.0 is distributed as `@yagyeshvyas/vibeguard@1.13.0`. If a
88
88
  registry mirror still serves an older build, use the exact
89
- [v1.12.0 GitHub release tarball](https://github.com/yagyeshVyas/VibeGuard/releases/tag/v1.12.0).
89
+ [v1.13.0 GitHub release tarball](https://github.com/yagyeshVyas/VibeGuard/releases/tag/v1.13.0).
90
90
 
91
91
  ## 🆕 What's New — v1.10.0
92
92
 
@@ -146,9 +146,9 @@ Full details, policy schema and honest limits: [MCP-FIREWALL.md](MCP-FIREWALL.md
146
146
 
147
147
  ---
148
148
 
149
- ## Security baseline v2 — v1.12.0 status (internal testing)
149
+ ## Security baseline v2 — v1.13.0 status (internal testing)
150
150
 
151
- This repository contains the v1.12.0 security foundation. It is **not** a
151
+ This repository contains the v1.13.0 security foundation. It is **not** a
152
152
  production-ready agent security platform. Linux network/PID namespace isolation
153
153
  is available; Windows/macOS OS isolation is not implemented.
154
154
 
@@ -166,8 +166,9 @@ Implemented and tested:
166
166
  - Authenticated loopback **HTTP JSON-RPC + SSE** MCP bridge with upstream stdio.
167
167
  - Optional **kill-on-block/block-budget** quarantine response.
168
168
  - **Linux bubblewrap** sandbox with verified network/PID/filesystem isolation,
169
- plus `unshare` fallback. **Windows Job Object** process/memory containment is
170
- available; AppContainer/WFP and macOS VM are still absent.
169
+ plus `unshare` fallback. **Windows Job Object** process/memory containment and
170
+ macOS `sandbox-exec` are available; AppContainer/WFP and macOS App Sandbox/VM
171
+ are still absent.
171
172
  - Memory provenance guard and signed multi-agent delegation library.
172
173
  - Labeled detection corpus runner and AISVS-style readiness mapping.
173
174
  - Target-controlled scanner plugins are **disabled by default**; code execution
@@ -184,16 +185,16 @@ Not implemented or not verified:
184
185
  Object provides process/memory containment only; it does not isolate files or
185
186
  network. Linux bubblewrap isolates network/PID/filesystem when installed, but
186
187
  is not a VM/hardware boundary.
187
- - **External audit anchor** is supported (`audit verify --anchor`); legacy
188
+ - **External audit anchor** and checkpoint sidecars are supported; legacy
188
189
  non-strict gateway audit is still the legacy hash chain.
189
- - **Approval service/UI**: `ApprovalBroker.decide()` now requires a signed
190
- approver proof; there is still no hosted approval UI/service.
191
- - Remote OAuth multi-session deployment; TLS/mTLS server options exist, but
192
- live OAuth authorization-server flow and persistence are not implemented.
190
+ - **Approval service**: hosted API with authenticated tickets, signed approver
191
+ proofs, JSON persistence, key rotation and a read-only dashboard; no SSO/IdP.
192
+ - A **local OAuth 2.1 code+PKCE server** and TLS/mTLS bridge options exist;
193
+ multi-session persistence and a full remote IdP/lifecycle remain incomplete.
193
194
  - Persistent memory/multi-agent runtime; `MemoryGuard`/`DelegationGraph` are
194
195
  tested libraries only.
195
196
  - Independent penetration test, representative precision/recall corpus, macOS
196
- full-suite evidence. npm 1.12.0 is published; GitHub Actions still lacks the
197
+ full-suite evidence. npm 1.13.0 is published; GitHub Actions still lacks the
197
198
  NPM_TOKEN secret and skips its publish step.
198
199
  - Dashboard/SDK and full AISVS certification; AISVS is an internal mapping.
199
200
 
@@ -688,6 +689,22 @@ _Per-category verdicts and full case list in [test/benchmark/benchmark-results.m
688
689
 
689
690
  Run `npm run benchmark` to reproduce. Per-category breakdown in `test/benchmark/benchmark-results.md`. The scorer runs the same de-duplication the product does, so it measures what a user actually sees rather than raw pre-dedupe rule hits. Still a self-built corpus — plans to run against OWASP Benchmark and publish those numbers alongside.
690
691
 
692
+ ### Independent/third-party testing
693
+
694
+ The numbers above come from a corpus this project built, so they flatter the
695
+ tool by construction. To give the claims something outside that loop, a scan of
696
+ an externally maintained target is published alongside them:
697
+ **[OWASP Juice Shop](test/third-party-benchmark.md)** (pinned commit, raw human
698
+ output, raw SARIF, and the exact commands).
699
+
700
+ That page is deliberately not a score. Juice Shop has no line-level
701
+ ground-truth labels, so precision/recall cannot be computed there the way the
702
+ self-built corpus allows; it is a reproducibility and sanity check, and it
703
+ records the false positives the run produced as plainly as the true positives.
704
+ Read it as evidence that the scanner runs end-to-end on code its author did not
705
+ write — not as a ranking, and not as a replacement for the 119/119 regression
706
+ gate.
707
+
691
708
  ---
692
709
 
693
710
  ## 🏆 Why VibeGuard wins vs. every other AI-era scanner