@yagyeshvyas/vibeguard 1.3.0 → 1.11.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 (167) hide show
  1. package/.vibeguard-mcp.example.json +51 -0
  2. package/CHANGELOG.md +604 -216
  3. package/MCP-FIREWALL.md +296 -0
  4. package/README.md +355 -31
  5. package/bin/cli.js +355 -27
  6. package/bin/cmd-agent-monitor.js +45 -0
  7. package/bin/cmd-agent-risk.js +64 -0
  8. package/bin/cmd-gif.js +62 -0
  9. package/bin/cmd-git-scan.js +74 -0
  10. package/bin/cmd-llm-proxy.js +164 -0
  11. package/bin/cmd-mcp-firewall.js +191 -0
  12. package/bin/cmd-pentest.js +103 -0
  13. package/bin/cmd-platform.js +137 -0
  14. package/bin/cmd-pr-scan.js +135 -0
  15. package/bin/cmd-sbom-diff.js +38 -0
  16. package/bin/cmd-skill-scan.js +35 -0
  17. package/docs/AISVS.md +25 -0
  18. package/docs/ARCHITECTURE.md +81 -0
  19. package/docs/INSTALLATION.md +139 -0
  20. package/docs/WINDOWS.md +74 -0
  21. package/docs/security-policy.strict.example.json +134 -0
  22. package/docs/security-policy.strict.example.pub.pem +3 -0
  23. package/package.json +45 -7
  24. package/src/.vibeguard/cache/file-hashes.json +60 -0
  25. package/src/.vibeguard/latest-snapshot.json +36 -0
  26. package/src/.vibeguard/mcp-pins.json +1 -0
  27. package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/auto.js +428 -0
  28. package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/daemon.js +344 -0
  29. package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/dashboard.js +279 -0
  30. package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/engine.js +297 -0
  31. package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/hook.js +151 -0
  32. package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/install.js +299 -0
  33. package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/manifest.json +65 -0
  34. package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/mcp-server.js +2051 -0
  35. package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/plugin.js +168 -0
  36. package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/pre-deploy.js +362 -0
  37. package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/repl.js +150 -0
  38. package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/rules.js +1611 -0
  39. package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/sbom.js +164 -0
  40. package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/shell-guard.js +292 -0
  41. package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/slopsquat.js +144 -0
  42. package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/trace.js +220 -0
  43. package/src/.vibeguard/snapshots/2026-08-05T16-26-26-074Z/auto.js +428 -0
  44. package/src/.vibeguard/snapshots/2026-08-05T16-26-26-074Z/daemon.js +344 -0
  45. package/src/.vibeguard/snapshots/2026-08-05T16-26-26-074Z/engine.js +297 -0
  46. package/src/.vibeguard/snapshots/2026-08-05T16-26-26-074Z/install.js +299 -0
  47. package/src/.vibeguard/snapshots/2026-08-05T16-26-26-074Z/manifest.json +37 -0
  48. package/src/.vibeguard/snapshots/2026-08-05T16-26-26-074Z/mcp-server.js +2055 -0
  49. package/src/.vibeguard/snapshots/2026-08-05T16-26-26-074Z/plugin.js +168 -0
  50. package/src/.vibeguard/snapshots/2026-08-05T16-26-26-074Z/pre-deploy.js +362 -0
  51. package/src/.vibeguard/snapshots/2026-08-05T16-26-26-074Z/trace.js +220 -0
  52. package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/auto.js +428 -0
  53. package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/daemon.js +344 -0
  54. package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/dashboard.js +279 -0
  55. package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/engine.js +297 -0
  56. package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/hook.js +151 -0
  57. package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/install.js +299 -0
  58. package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/manifest.json +65 -0
  59. package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/mcp-server.js +2055 -0
  60. package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/plugin.js +168 -0
  61. package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/pre-deploy.js +362 -0
  62. package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/repl.js +150 -0
  63. package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/rules.js +1611 -0
  64. package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/sbom.js +164 -0
  65. package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/shell-guard.js +292 -0
  66. package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/slopsquat.js +144 -0
  67. package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/trace.js +220 -0
  68. package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/auto.js +428 -0
  69. package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/daemon.js +344 -0
  70. package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/dashboard.js +279 -0
  71. package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/engine.js +297 -0
  72. package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/hook.js +151 -0
  73. package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/install.js +299 -0
  74. package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/manifest.json +65 -0
  75. package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/mcp-server.js +2054 -0
  76. package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/plugin.js +168 -0
  77. package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/pre-deploy.js +362 -0
  78. package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/repl.js +150 -0
  79. package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/rules.js +1611 -0
  80. package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/sbom.js +164 -0
  81. package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/shell-guard.js +292 -0
  82. package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/slopsquat.js +144 -0
  83. package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/trace.js +220 -0
  84. package/src/.vibeguard/snapshots/2026-08-05T18-11-32-644Z/auto.js +428 -0
  85. package/src/.vibeguard/snapshots/2026-08-05T18-11-32-644Z/daemon.js +344 -0
  86. package/src/.vibeguard/snapshots/2026-08-05T18-11-32-644Z/engine.js +297 -0
  87. package/src/.vibeguard/snapshots/2026-08-05T18-11-32-644Z/install.js +299 -0
  88. package/src/.vibeguard/snapshots/2026-08-05T18-11-32-644Z/manifest.json +37 -0
  89. package/src/.vibeguard/snapshots/2026-08-05T18-11-32-644Z/mcp-server.js +2055 -0
  90. package/src/.vibeguard/snapshots/2026-08-05T18-11-32-644Z/plugin.js +168 -0
  91. package/src/.vibeguard/snapshots/2026-08-05T18-11-32-644Z/pre-deploy.js +362 -0
  92. package/src/.vibeguard/snapshots/2026-08-05T18-11-32-644Z/trace.js +220 -0
  93. package/src/.vibeguard/snapshots/2026-08-05T18-16-47-635Z/auto.js +428 -0
  94. package/src/.vibeguard/snapshots/2026-08-05T18-16-47-635Z/daemon.js +344 -0
  95. package/src/.vibeguard/snapshots/2026-08-05T18-16-47-635Z/engine.js +297 -0
  96. package/src/.vibeguard/snapshots/2026-08-05T18-16-47-635Z/manifest.json +33 -0
  97. package/src/.vibeguard/snapshots/2026-08-05T18-16-47-635Z/mcp-server.js +2055 -0
  98. package/src/.vibeguard/snapshots/2026-08-05T18-16-47-635Z/rules.js +1611 -0
  99. package/src/.vibeguard/snapshots/2026-08-05T18-16-47-635Z/shell-guard.js +292 -0
  100. package/src/.vibeguard/snapshots/2026-08-05T18-16-47-635Z/trace.js +220 -0
  101. package/src/.vibeguard-baseline.json +5226 -0
  102. package/src/action-guard.js +84 -6
  103. package/src/agent-monitor.js +262 -0
  104. package/src/agent-policy.js +642 -0
  105. package/src/agent-risk.js +271 -0
  106. package/src/agentic.js +1513 -0
  107. package/src/ast.js +165 -7
  108. package/src/audit-trail.js +212 -67
  109. package/src/auto.js +427 -427
  110. package/src/autofix.js +11 -4
  111. package/src/bundles.js +198 -0
  112. package/src/daemon.js +343 -343
  113. package/src/dashboard.js +278 -278
  114. package/src/engine.js +3 -0
  115. package/src/entropy.js +187 -0
  116. package/src/firewall.js +19 -3
  117. package/src/gif.js +134 -0
  118. package/src/gitscan.js +282 -0
  119. package/src/hook.js +151 -151
  120. package/src/injection-decode.js +136 -0
  121. package/src/install.js +298 -280
  122. package/src/integrity.js +16 -1
  123. package/src/integrity.json +43 -13
  124. package/src/interceptor.js +12 -9
  125. package/src/llm-proxy.js +986 -0
  126. package/src/mcp-audit.js +61 -5
  127. package/src/mcp-firewall.js +971 -0
  128. package/src/mcp-server.js +2500 -2047
  129. package/src/obfuscation.js +315 -0
  130. package/src/owasp-agentic.js +314 -0
  131. package/src/pentest.js +589 -0
  132. package/src/pii.js +4 -0
  133. package/src/platform/aisvs.js +38 -0
  134. package/src/platform/approval.js +187 -0
  135. package/src/platform/canonical.js +73 -0
  136. package/src/platform/contracts.js +158 -0
  137. package/src/platform/delegation.js +73 -0
  138. package/src/platform/http-gateway.js +177 -0
  139. package/src/platform/identity.js +253 -0
  140. package/src/platform/jwt.js +86 -0
  141. package/src/platform/mcp-http-bridge.js +199 -0
  142. package/src/platform/memory-guard.js +64 -0
  143. package/src/platform/os-sandbox.js +144 -0
  144. package/src/platform/policy.js +332 -0
  145. package/src/platform/sandbox-manager.js +92 -0
  146. package/src/platform/signed-audit.js +357 -0
  147. package/src/platform/ssrf.js +129 -0
  148. package/src/plugin.js +182 -168
  149. package/src/pre-deploy.js +170 -55
  150. package/src/privacy-audit.js +272 -272
  151. package/src/repl.js +150 -150
  152. package/src/report.js +7 -1
  153. package/src/routes.js +1210 -0
  154. package/src/rules-2026.js +1407 -0
  155. package/src/rules-pack.js +3068 -3019
  156. package/src/rules.js +376 -60
  157. package/src/sandbox.js +200 -10
  158. package/src/sbom.js +193 -164
  159. package/src/scanner.js +189 -33
  160. package/src/shell-guard.js +11 -0
  161. package/src/skill-scan.js +477 -0
  162. package/src/slopsquat.js +144 -144
  163. package/src/surface.js +408 -0
  164. package/src/taint-ast.js +204 -37
  165. package/src/taint.js +15 -3
  166. package/src/tokenlean.js +579 -0
  167. package/src/trace.js +220 -220
@@ -0,0 +1,297 @@
1
+ 'use strict';
2
+
3
+ /*
4
+ * Engine gaps:
5
+ * 1. Sanitizer recognition — stop taint propagation when a sanitizer is applied
6
+ * 2. Incremental/diff-aware scanning — only scan changed files
7
+ * 3. Auth coverage map — enumerate routes → middleware → guards
8
+ * 4. Python taint — basic Python source-to-sink taint detection
9
+ */
10
+
11
+ const fs = require('fs');
12
+ const path = require('path');
13
+ const crypto = require('crypto');
14
+
15
+ // ---------------------------------------------------------------------------
16
+ // 1. SANITIZER RECOGNITION
17
+ // ---------------------------------------------------------------------------
18
+
19
+ const SANITIZERS = {
20
+ xss: [
21
+ 'DOMPurify', 'sanitize', 'sanitizeHtml', 'escape', 'escapeHtml',
22
+ 'encodeURIComponent', 'encodeURI', 'textEncode', 'he.encode',
23
+ 'React.createElement', 'textContent',
24
+ ],
25
+ sql: [
26
+ 'parameterize', 'prepare', 'placeholder', 'bind', 'sql`', 'sql.query',
27
+ 'prisma.$queryRaw', 'pool.query', 'client.query',
28
+ ],
29
+ cmd: [
30
+ 'execFile', 'spawn', 'shell-quote', 'shellescape', 'sanitizeShell',
31
+ ],
32
+ path: [
33
+ 'path.resolve', 'path.join', 'path.normalize', 'sanitize',
34
+ ],
35
+ };
36
+
37
+ function isSanitized(expr, type) {
38
+ if (!expr || typeof expr !== 'string') return false;
39
+ const sanitizers = SANITIZERS[type] || [];
40
+ return sanitizers.some((s) => expr.includes(s));
41
+ }
42
+
43
+ // ---------------------------------------------------------------------------
44
+ // 2. INCREMENTAL / DIFF-AWARE SCANNING
45
+ // ---------------------------------------------------------------------------
46
+
47
+ const HASH_CACHE_DIR = '.vibeguard/cache';
48
+
49
+ function loadHashCache(root) {
50
+ const p = path.join(root, HASH_CACHE_DIR, 'file-hashes.json');
51
+ if (fs.existsSync(p)) {
52
+ try { return JSON.parse(fs.readFileSync(p, 'utf8')); } catch {}
53
+ }
54
+ return {};
55
+ }
56
+
57
+ function saveHashCache(root, cache) {
58
+ const dir = path.join(root, HASH_CACHE_DIR);
59
+ if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
60
+ fs.writeFileSync(path.join(dir, 'file-hashes.json'), JSON.stringify(cache, null, 2));
61
+ }
62
+
63
+ function hashContent(content) {
64
+ return crypto.createHash('sha256').update(content).digest('hex');
65
+ }
66
+
67
+ function getChangedFiles(root, allFiles) {
68
+ const cache = loadHashCache(root);
69
+ const changed = [];
70
+ const newCache = {};
71
+
72
+ for (const file of allFiles) {
73
+ try {
74
+ const content = fs.readFileSync(file, 'utf8');
75
+ const hash = hashContent(content);
76
+ newCache[file] = hash;
77
+ if (cache[file] !== hash) changed.push(file);
78
+ } catch {
79
+ // can't read, skip
80
+ }
81
+ }
82
+
83
+ saveHashCache(root, newCache);
84
+ return { changed, total: allFiles.length, cached: allFiles.length - changed.length };
85
+ }
86
+
87
+ // ---------------------------------------------------------------------------
88
+ // 3. AUTH COVERAGE MAP
89
+ // ---------------------------------------------------------------------------
90
+
91
+ const ROUTE_RE = /(?:app|router|server)\.(?:get|post|put|delete|patch|all|use)\s*\(\s*['"`]([^'"`]+)['"`]/gi;
92
+ const MIDDLEWARE_RE = /(?:app|router)\.use\s*\(\s*['"`]([^'"`]+)['"`]/gi;
93
+ const AUTH_GUARD_RE = /(?:requireAuth|withAuth|protect|guard|authMiddleware|isAuthenticated|verifyToken|authenticate|clerkMiddleware|auth\(\)|getServerSession|getSession)/i;
94
+
95
+ function buildAuthCoverage(root, files) {
96
+ const routes = [];
97
+ const middlewares = [];
98
+
99
+ for (const file of files) {
100
+ try {
101
+ const content = fs.readFileSync(file, 'utf8');
102
+ const relPath = path.relative(root, file);
103
+
104
+ let m;
105
+ while ((m = ROUTE_RE.exec(content)) !== null) {
106
+ const routePath = m[1];
107
+ const beforeLines = content.slice(0, m.index).split('\n');
108
+ const lineNum = beforeLines.length;
109
+ const currentLine = content.slice(m.index, m.index + 300).split('\n')[0];
110
+ const hasAuth = AUTH_GUARD_RE.test(currentLine);
111
+ routes.push({
112
+ path: routePath,
113
+ file: relPath,
114
+ line: lineNum,
115
+ protected: hasAuth,
116
+ });
117
+ }
118
+
119
+ while ((m = MIDDLEWARE_RE.exec(content)) !== null) {
120
+ const mwPath = m[1];
121
+ const lines = content.slice(0, m.index).split('\n');
122
+ const lineNum = lines.length;
123
+ const surrounding = content.slice(m.index, m.index + 300);
124
+ const isAuth = AUTH_GUARD_RE.test(surrounding);
125
+ if (isAuth) {
126
+ middlewares.push({ path: mwPath, file: relPath, line: lineNum });
127
+ }
128
+ }
129
+ } catch {}
130
+ }
131
+
132
+ const unprotected = routes.filter((r) => !r.protected && r.path.startsWith('/api/'));
133
+ const protectedRoutes = routes.filter((r) => r.protected);
134
+
135
+ return {
136
+ totalRoutes: routes.length,
137
+ protectedRoutes: protectedRoutes.length,
138
+ unprotectedRoutes: unprotected.length,
139
+ unprotected,
140
+ middlewares,
141
+ coverage: routes.length > 0 ? Math.round((protectedRoutes.length / routes.length) * 100) : 100,
142
+ };
143
+ }
144
+
145
+ // ---------------------------------------------------------------------------
146
+ // 4. PYTHON TAINT (basic — regex-based, no AST)
147
+ // ---------------------------------------------------------------------------
148
+
149
+ const PY_SOURCES = [
150
+ { re: /request\.(?:form|args|data|json|values|cookies|headers)(?:\.\w+)?\s*\(/g, name: 'request' },
151
+ { re: /request\.get\s*\(/g, name: 'request' },
152
+ { re: /\binput\s*\(/g, name: 'input()' },
153
+ { re: /os\.environ\.get\s*\(/g, name: 'os.environ' },
154
+ { re: /sys\.argv/g, name: 'sys.argv' },
155
+ { re: /os\.getenv\s*\(/g, name: 'os.getenv' },
156
+ ];
157
+
158
+ const PY_SINKS = [
159
+ { re: /cursor\.execute\s*\(/g, name: 'cursor.execute', type: 'sql' },
160
+ { re: /os\.system\s*\(/g, name: 'os.system', type: 'cmd' },
161
+ { re: /subprocess\.(?:run|call|Popen)\s*\(/g, name: 'subprocess', type: 'cmd' },
162
+ { re: /eval\s*\(/g, name: 'eval()', type: 'code' },
163
+ { re: /exec\s*\(/g, name: 'exec()', type: 'code' },
164
+ { re: /open\s*\(/g, name: 'open()', type: 'file' },
165
+ { re: /pickle\.loads?\s*\(/g, name: 'pickle', type: 'deserialization' },
166
+ { re: /yaml\.load\s*\(/g, name: 'yaml.load', type: 'deserialization' },
167
+ { re: /shutil\.rmtree\s*\(/g, name: 'shutil.rmtree', type: 'file' },
168
+ ];
169
+
170
+ // Single-pass taint propagation (pure JS — no external parser, keeps VibeGuard
171
+ // zero-dependency and offline). Tracks tainted variables top-to-bottom:
172
+ // - a source assignment (v = request.form.get(...)) taints v;
173
+ // - an assignment whose RHS references a tainted var propagates the taint to
174
+ // the LHS (multi-hop: q = "..." + data → q is tainted);
175
+ // - reassigning a tainted var to a clean/sanitized value clears it;
176
+ // - a sink using a tainted var fires — UNLESS the value is parameterized
177
+ // (SQL) or wrapped in a sanitizer at the sink.
178
+ // This replaces the old "var appears anywhere between source and sink" heuristic,
179
+ // which false-positived when a tainted name merely appeared near an unrelated sink.
180
+ function analyzePythonTaint(content, lines, relPath) {
181
+ const findings = [];
182
+ const tainted = new Map(); // varName -> { name (source), line }
183
+ const seen = new Set(); // dedupe sink:line
184
+ const reOf = (v) => new RegExp('\\b' + escapeRe(v) + '\\b');
185
+
186
+ for (let i = 0; i < lines.length; i++) {
187
+ const line = lines[i];
188
+ const lineNo = i + 1;
189
+
190
+ // 1. Source assignment.
191
+ let matchedSource = null;
192
+ for (const src of PY_SOURCES) {
193
+ src.re.lastIndex = 0;
194
+ if (src.re.test(line)) { matchedSource = src.name; break; }
195
+ }
196
+ if (matchedSource) {
197
+ const v = extractVarName(line);
198
+ if (v) tainted.set(v, { name: matchedSource, line: lineNo });
199
+ }
200
+
201
+ // 2. Propagation / clearing via simple assignment `lhs = rhs`.
202
+ if (!matchedSource) {
203
+ const asn = /^\s*([A-Za-z_]\w*)\s*=\s*(.+)$/.exec(line);
204
+ if (asn) {
205
+ const lhs = asn[1];
206
+ const rhs = asn[2];
207
+ let carried = null;
208
+ for (const [tv, info] of tainted) {
209
+ if (reOf(tv).test(rhs) && !isSanitizedAtSink(rhs, tv)) { carried = info; break; }
210
+ }
211
+ if (carried) tainted.set(lhs, carried);
212
+ else if (tainted.has(lhs)) tainted.delete(lhs); // reassigned to clean value
213
+ }
214
+ }
215
+
216
+ // 3. Sinks.
217
+ for (const sink of PY_SINKS) {
218
+ sink.re.lastIndex = 0;
219
+ if (!sink.re.test(line)) continue;
220
+ for (const [tv, info] of tainted) {
221
+ if (!reOf(tv).test(line)) continue;
222
+ if (sink.type === 'sql' && isParameterizedExecute(line)) continue;
223
+ if (isSanitizedAtSink(line, tv)) continue;
224
+ const key = sink.name + ':' + lineNo;
225
+ if (seen.has(key)) break;
226
+ seen.add(key);
227
+ findings.push({
228
+ ruleId: 'py.taint-flow',
229
+ file: relPath,
230
+ line: lineNo,
231
+ column: 1,
232
+ severity: 'high',
233
+ confidence: 'medium',
234
+ title: `Python taint: ${info.name} → ${sink.name}`,
235
+ snippet: line.trim().slice(0, 120),
236
+ message: `User input (${info.name} at line ${info.line}) flows to ${sink.name} (line ${lineNo}) without sanitization.`,
237
+ fix: `Sanitize or validate the input before passing it to ${sink.name}.`,
238
+ owasp: 'A03:2025 Injection',
239
+ cwe: sink.type === 'sql' ? 'CWE-89' : sink.type === 'cmd' ? 'CWE-77' : 'CWE-20',
240
+ });
241
+ break;
242
+ }
243
+ }
244
+ }
245
+
246
+ return findings;
247
+ }
248
+
249
+ function escapeRe(s) {
250
+ return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
251
+ }
252
+
253
+ // Parameterized DB call: a placeholder in the query AND a second argument to
254
+ // execute() = the driver binds/escapes the value, so it is NOT SQL injection.
255
+ function isParameterizedExecute(line) {
256
+ if (!/\.execute\s*\(/.test(line)) return false;
257
+ const hasPlaceholder = /%s|%\(|%d|\?|:\w+/.test(line);
258
+ const hasSecondArg = /\.execute\s*\([^)]*?,\s*[([{\w'"]/.test(line);
259
+ return hasPlaceholder && hasSecondArg;
260
+ }
261
+
262
+ // Python sanitizers that neutralize a tainted value. If the tainted var appears
263
+ // wrapped in one of these on the sink line, the flow is considered safe.
264
+ const PY_SANITIZER_FNS = [
265
+ 'int', 'float', 'bool', 'decimal.Decimal',
266
+ 'shlex.quote', 'pipes.quote', 'shlex.split',
267
+ 'html.escape', 'markupsafe.escape', 'escape', 'bleach.clean',
268
+ 'urllib.parse.quote', 'urllib.parse.quote_plus', 're.escape',
269
+ ];
270
+ function isSanitizedAtSink(sinkLine, varName) {
271
+ const v = varName.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
272
+ for (const fn of PY_SANITIZER_FNS) {
273
+ const f = fn.replace(/\./g, '\\.');
274
+ // e.g. int(<var>) / shlex.quote(<var>) directly wrapping the tainted var
275
+ if (new RegExp('\\b' + f + '\\s*\\(\\s*' + v + '\\b').test(sinkLine)) return true;
276
+ }
277
+ return false;
278
+ }
279
+
280
+ function extractVarName(line) {
281
+ const m = /\b(\w+)\s*=\s*(?:request\.|input\(|os\.environ|sys\.argv)/.exec(line);
282
+ if (m) return m[1];
283
+ const m2 = /\b(?:for\s+)?(\w+)\s+in\s+request\./.exec(line);
284
+ if (m2) return m2[1];
285
+ return null;
286
+ }
287
+
288
+ module.exports = {
289
+ isSanitized,
290
+ SANITIZERS,
291
+ getChangedFiles,
292
+ loadHashCache,
293
+ saveHashCache,
294
+ hashContent,
295
+ buildAuthCoverage,
296
+ analyzePythonTaint,
297
+ };
@@ -0,0 +1,151 @@
1
+ 'use strict';
2
+
3
+ /*
4
+ * VibeGuard Real-Time Hook — PostToolUse auto-scan.
5
+ *
6
+ * This module provides two integration modes:
7
+ *
8
+ * 1. Claude Code hook (settings.json):
9
+ * Add to .claude/settings.json:
10
+ * {
11
+ * "hooks": {
12
+ * "PostToolUse": [{
13
+ * "matcher": "Edit|Write|MultiEdit",
14
+ * "hooks": [{ "type": "command", "command": "npx -y @yagyeshvyas/vibeguard hook-post-edit" }]
15
+ * }]
16
+ * }
17
+ * }
18
+ * After every file edit/write by Claude Code, VibeGuard scans the changed file
19
+ * and prints warnings if security issues are found.
20
+ *
21
+ * 2. Generic file watcher (any AI tool):
22
+ * vibeguard watch-post-edit
23
+ * Watches the current directory for file changes and auto-scans them.
24
+ *
25
+ * 3. Git pre-commit hook (already exists via `vibeguard install-hook`).
26
+ *
27
+ * All modes are ZERO-COST — no API calls, no network, pure local scanning.
28
+ */
29
+
30
+ const fs = require('fs');
31
+ const path = require('path');
32
+ const { scanFileContent } = require('./scanner');
33
+ const { computeGrade } = require('./scanner');
34
+
35
+ const C = {
36
+ red: '\x1b[31m', green: '\x1b[32m', yellow: '\x1b[33m',
37
+ blue: '\x1b[34m', cyan: '\x1b[36m', dim: '\x1b[2m',
38
+ bold: '\x1b[1m', reset: '\x1b[0m',
39
+ };
40
+
41
+ // Called by Claude Code PostToolUse hook — reads the tool input from stdin
42
+ // (Claude Code pipes the tool result as JSON on stdin).
43
+ function handlePostEdit() {
44
+ let input = '';
45
+ process.stdin.setEncoding('utf8');
46
+ process.stdin.on('data', (chunk) => (input += chunk));
47
+ process.stdin.on('end', () => {
48
+ let toolInput;
49
+ try { toolInput = JSON.parse(input); } catch { return; }
50
+
51
+ // Claude Code PostToolUse sends { tool_name, tool_input, tool_result }
52
+ const toolName = toolInput.tool_name || toolInput.toolName || '';
53
+ const toolInputData = toolInput.tool_input || toolInput.toolInput || {};
54
+ const filePath = toolInputData.file_path || toolInputData.filePath || toolInputData.path || '';
55
+
56
+ if (!filePath || !fs.existsSync(filePath)) {
57
+ return; // no file to scan
58
+ }
59
+
60
+ // Only scan code files
61
+ const ext = path.extname(filePath).toLowerCase();
62
+ const scanExts = new Set(['.js', '.jsx', '.ts', '.tsx', '.py', '.go', '.rb', '.php', '.java', '.kt', '.swift', '.m', '.sh', '.yml', '.yaml', '.json', '.toml', '.sql', '.env', '.dockerfile', '.tf']);
63
+ if (!scanExts.has(ext) && !/^Dockerfile/i.test(path.basename(filePath))) return;
64
+
65
+ try {
66
+ const content = fs.readFileSync(filePath, 'utf8');
67
+ const relPath = path.relative(process.cwd(), filePath);
68
+ const findings = scanFileContent(filePath, relPath, content, null);
69
+
70
+ if (findings.length === 0) return;
71
+
72
+ // Print warnings to stderr (Claude Code captures stderr and shows it)
73
+ const critical = findings.filter(f => f.severity === 'critical');
74
+ const high = findings.filter(f => f.severity === 'high');
75
+ const medium = findings.filter(f => f.severity === 'medium');
76
+
77
+ if (critical.length > 0 || high.length > 0) {
78
+ process.stderr.write(`\n${C.red}${C.bold}VibeGuard: ${critical.length} critical, ${high.length} high in ${relPath}${C.reset}\n`);
79
+ for (const f of [...critical, ...high].slice(0, 10)) {
80
+ process.stderr.write(` ${C.red}[${f.severity}]${C.reset} ${f.ruleId} ${C.dim}line ${f.line}${C.reset} — ${f.message}\n`);
81
+ if (f.fix) process.stderr.write(` ${C.green}fix:${C.reset} ${f.fix}\n`);
82
+ }
83
+ process.stderr.write(`${C.dim}Run 'vibeguard scan' for full report.${C.reset}\n\n`);
84
+ } else if (medium.length > 0) {
85
+ process.stderr.write(`\n${C.yellow}VibeGuard: ${medium.length} medium findings in ${relPath}${C.reset}\n`);
86
+ for (const f of medium.slice(0, 5)) {
87
+ process.stderr.write(` ${C.yellow}[medium]${C.reset} ${f.ruleId} ${C.dim}line ${f.line}${C.reset}\n`);
88
+ }
89
+ process.stderr.write(`\n`);
90
+ }
91
+ } catch {
92
+ // silent fail — never block the AI from working
93
+ }
94
+ });
95
+ }
96
+
97
+ // Install the PostToolUse hook into Claude Code's settings.json
98
+ function installPostEditHook(dir) {
99
+ const settingsDir = path.join(dir, '.claude');
100
+ const settingsFile = path.join(settingsDir, 'settings.json');
101
+
102
+ let settings = {};
103
+ try {
104
+ settings = JSON.parse(fs.readFileSync(settingsFile, 'utf8'));
105
+ } catch {}
106
+
107
+ if (!settings.hooks) settings.hooks = {};
108
+ if (!settings.hooks.PostToolUse) settings.hooks.PostToolUse = [];
109
+
110
+ // Check if already installed
111
+ const exists = settings.hooks.PostToolUse.some(
112
+ h => h.hooks && h.hooks.some(hh => hh.command && (hh.command.includes('vibeguard') || hh.command.includes('hook-post-edit')))
113
+ );
114
+ if (exists) return { installed: false, reason: 'already present' };
115
+
116
+ const cliPath = path.resolve(__dirname, '..', 'bin', 'cli.js');
117
+ const nodeBin = process.execPath;
118
+ const cmd = process.platform === 'win32'
119
+ ? `"${nodeBin}" "${cliPath}" hook-post-edit`
120
+ : `node "${cliPath}" hook-post-edit`;
121
+
122
+ settings.hooks.PostToolUse.push({
123
+ matcher: 'Edit|Write|MultiEdit',
124
+ hooks: [{ type: 'command', command: cmd }],
125
+ });
126
+
127
+ fs.mkdirSync(settingsDir, { recursive: true });
128
+ fs.writeFileSync(settingsFile, JSON.stringify(settings, null, 2) + '\n');
129
+ return { installed: true, file: settingsFile };
130
+ }
131
+
132
+ // Remove the PostToolUse hook
133
+ function uninstallPostEditHook(dir) {
134
+ const settingsFile = path.join(dir, '.claude', 'settings.json');
135
+ let settings;
136
+ try { settings = JSON.parse(fs.readFileSync(settingsFile, 'utf8')); } catch { return { uninstalled: false, reason: 'no settings.json' }; }
137
+ if (!settings.hooks || !settings.hooks.PostToolUse) return { uninstalled: false, reason: 'no PostToolUse hooks' };
138
+
139
+ const before = settings.hooks.PostToolUse.length;
140
+ settings.hooks.PostToolUse = settings.hooks.PostToolUse.filter(
141
+ h => !h.hooks || !h.hooks.some(hh => hh.command && (hh.command.includes('vibeguard') || hh.command.includes('hook-post-edit')))
142
+ );
143
+ const afterLen = settings.hooks.PostToolUse ? settings.hooks.PostToolUse.length : 0;
144
+ if (settings.hooks.PostToolUse && settings.hooks.PostToolUse.length === 0) delete settings.hooks.PostToolUse;
145
+ if (settings.hooks && Object.keys(settings.hooks).length === 0) delete settings.hooks;
146
+
147
+ fs.writeFileSync(settingsFile, JSON.stringify(settings, null, 2) + '\n');
148
+ return { uninstalled: before > afterLen };
149
+ }
150
+
151
+ module.exports = { handlePostEdit, installPostEditHook, uninstallPostEditHook };