@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.
- package/.vibeguard-mcp.example.json +51 -0
- package/CHANGELOG.md +604 -216
- package/MCP-FIREWALL.md +296 -0
- package/README.md +355 -31
- package/bin/cli.js +355 -27
- package/bin/cmd-agent-monitor.js +45 -0
- package/bin/cmd-agent-risk.js +64 -0
- package/bin/cmd-gif.js +62 -0
- package/bin/cmd-git-scan.js +74 -0
- package/bin/cmd-llm-proxy.js +164 -0
- package/bin/cmd-mcp-firewall.js +191 -0
- package/bin/cmd-pentest.js +103 -0
- package/bin/cmd-platform.js +137 -0
- package/bin/cmd-pr-scan.js +135 -0
- package/bin/cmd-sbom-diff.js +38 -0
- package/bin/cmd-skill-scan.js +35 -0
- package/docs/AISVS.md +25 -0
- package/docs/ARCHITECTURE.md +81 -0
- package/docs/INSTALLATION.md +139 -0
- package/docs/WINDOWS.md +74 -0
- package/docs/security-policy.strict.example.json +134 -0
- package/docs/security-policy.strict.example.pub.pem +3 -0
- package/package.json +45 -7
- package/src/.vibeguard/cache/file-hashes.json +60 -0
- package/src/.vibeguard/latest-snapshot.json +36 -0
- package/src/.vibeguard/mcp-pins.json +1 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/auto.js +428 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/daemon.js +344 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/dashboard.js +279 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/engine.js +297 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/hook.js +151 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/install.js +299 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/manifest.json +65 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/mcp-server.js +2051 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/plugin.js +168 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/pre-deploy.js +362 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/repl.js +150 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/rules.js +1611 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/sbom.js +164 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/shell-guard.js +292 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/slopsquat.js +144 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-23-50-635Z/trace.js +220 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-26-26-074Z/auto.js +428 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-26-26-074Z/daemon.js +344 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-26-26-074Z/engine.js +297 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-26-26-074Z/install.js +299 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-26-26-074Z/manifest.json +37 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-26-26-074Z/mcp-server.js +2055 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-26-26-074Z/plugin.js +168 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-26-26-074Z/pre-deploy.js +362 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-26-26-074Z/trace.js +220 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/auto.js +428 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/daemon.js +344 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/dashboard.js +279 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/engine.js +297 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/hook.js +151 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/install.js +299 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/manifest.json +65 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/mcp-server.js +2055 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/plugin.js +168 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/pre-deploy.js +362 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/repl.js +150 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/rules.js +1611 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/sbom.js +164 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/shell-guard.js +292 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/slopsquat.js +144 -0
- package/src/.vibeguard/snapshots/2026-08-05T16-35-06-272Z/trace.js +220 -0
- package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/auto.js +428 -0
- package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/daemon.js +344 -0
- package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/dashboard.js +279 -0
- package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/engine.js +297 -0
- package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/hook.js +151 -0
- package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/install.js +299 -0
- package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/manifest.json +65 -0
- package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/mcp-server.js +2054 -0
- package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/plugin.js +168 -0
- package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/pre-deploy.js +362 -0
- package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/repl.js +150 -0
- package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/rules.js +1611 -0
- package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/sbom.js +164 -0
- package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/shell-guard.js +292 -0
- package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/slopsquat.js +144 -0
- package/src/.vibeguard/snapshots/2026-08-05T18-08-40-613Z/trace.js +220 -0
- package/src/.vibeguard/snapshots/2026-08-05T18-11-32-644Z/auto.js +428 -0
- package/src/.vibeguard/snapshots/2026-08-05T18-11-32-644Z/daemon.js +344 -0
- package/src/.vibeguard/snapshots/2026-08-05T18-11-32-644Z/engine.js +297 -0
- package/src/.vibeguard/snapshots/2026-08-05T18-11-32-644Z/install.js +299 -0
- package/src/.vibeguard/snapshots/2026-08-05T18-11-32-644Z/manifest.json +37 -0
- package/src/.vibeguard/snapshots/2026-08-05T18-11-32-644Z/mcp-server.js +2055 -0
- package/src/.vibeguard/snapshots/2026-08-05T18-11-32-644Z/plugin.js +168 -0
- package/src/.vibeguard/snapshots/2026-08-05T18-11-32-644Z/pre-deploy.js +362 -0
- package/src/.vibeguard/snapshots/2026-08-05T18-11-32-644Z/trace.js +220 -0
- package/src/.vibeguard/snapshots/2026-08-05T18-16-47-635Z/auto.js +428 -0
- package/src/.vibeguard/snapshots/2026-08-05T18-16-47-635Z/daemon.js +344 -0
- package/src/.vibeguard/snapshots/2026-08-05T18-16-47-635Z/engine.js +297 -0
- package/src/.vibeguard/snapshots/2026-08-05T18-16-47-635Z/manifest.json +33 -0
- package/src/.vibeguard/snapshots/2026-08-05T18-16-47-635Z/mcp-server.js +2055 -0
- package/src/.vibeguard/snapshots/2026-08-05T18-16-47-635Z/rules.js +1611 -0
- package/src/.vibeguard/snapshots/2026-08-05T18-16-47-635Z/shell-guard.js +292 -0
- package/src/.vibeguard/snapshots/2026-08-05T18-16-47-635Z/trace.js +220 -0
- package/src/.vibeguard-baseline.json +5226 -0
- package/src/action-guard.js +84 -6
- package/src/agent-monitor.js +262 -0
- package/src/agent-policy.js +642 -0
- package/src/agent-risk.js +271 -0
- package/src/agentic.js +1513 -0
- package/src/ast.js +165 -7
- package/src/audit-trail.js +212 -67
- package/src/auto.js +427 -427
- package/src/autofix.js +11 -4
- package/src/bundles.js +198 -0
- package/src/daemon.js +343 -343
- package/src/dashboard.js +278 -278
- package/src/engine.js +3 -0
- package/src/entropy.js +187 -0
- package/src/firewall.js +19 -3
- package/src/gif.js +134 -0
- package/src/gitscan.js +282 -0
- package/src/hook.js +151 -151
- package/src/injection-decode.js +136 -0
- package/src/install.js +298 -280
- package/src/integrity.js +16 -1
- package/src/integrity.json +43 -13
- package/src/interceptor.js +12 -9
- package/src/llm-proxy.js +986 -0
- package/src/mcp-audit.js +61 -5
- package/src/mcp-firewall.js +971 -0
- package/src/mcp-server.js +2500 -2047
- package/src/obfuscation.js +315 -0
- package/src/owasp-agentic.js +314 -0
- package/src/pentest.js +589 -0
- package/src/pii.js +4 -0
- package/src/platform/aisvs.js +38 -0
- package/src/platform/approval.js +187 -0
- package/src/platform/canonical.js +73 -0
- package/src/platform/contracts.js +158 -0
- package/src/platform/delegation.js +73 -0
- package/src/platform/http-gateway.js +177 -0
- package/src/platform/identity.js +253 -0
- package/src/platform/jwt.js +86 -0
- package/src/platform/mcp-http-bridge.js +199 -0
- package/src/platform/memory-guard.js +64 -0
- package/src/platform/os-sandbox.js +144 -0
- package/src/platform/policy.js +332 -0
- package/src/platform/sandbox-manager.js +92 -0
- package/src/platform/signed-audit.js +357 -0
- package/src/platform/ssrf.js +129 -0
- package/src/plugin.js +182 -168
- package/src/pre-deploy.js +170 -55
- package/src/privacy-audit.js +272 -272
- package/src/repl.js +150 -150
- package/src/report.js +7 -1
- package/src/routes.js +1210 -0
- package/src/rules-2026.js +1407 -0
- package/src/rules-pack.js +3068 -3019
- package/src/rules.js +376 -60
- package/src/sandbox.js +200 -10
- package/src/sbom.js +193 -164
- package/src/scanner.js +189 -33
- package/src/shell-guard.js +11 -0
- package/src/skill-scan.js +477 -0
- package/src/slopsquat.js +144 -144
- package/src/surface.js +408 -0
- package/src/taint-ast.js +204 -37
- package/src/taint.js +15 -3
- package/src/tokenlean.js +579 -0
- package/src/trace.js +220 -220
|
@@ -0,0 +1,271 @@
|
|
|
1
|
+
'use strict';
|
|
2
|
+
|
|
3
|
+
/*
|
|
4
|
+
* src/agent-risk.js — one risk score for an AI-agent deployment.
|
|
5
|
+
*
|
|
6
|
+
* Existing VibeGuard scores answer "how risky is this code?" This answers a
|
|
7
|
+
* different question: "how risky is this agent, right now?" It aggregates:
|
|
8
|
+
*
|
|
9
|
+
* config — MCP servers the agent trusts (tool poisoning, unpinned, shells,
|
|
10
|
+
* secrets, broad filesystem grants, shadow servers, drift)
|
|
11
|
+
* skills — skill / plugin / instruction files that shape agent behavior
|
|
12
|
+
* runtime — what the MCP firewall actually blocked, warned and scrubbed,
|
|
13
|
+
* plus behavioral anomalies in those events
|
|
14
|
+
* policy — is there an explicit permission policy, or only defaults?
|
|
15
|
+
* audit — is the audit trail present, writable and hash-intact?
|
|
16
|
+
*
|
|
17
|
+
* Score is 0-100, higher is worse. Grade A-F mirrors the scanner's scale.
|
|
18
|
+
* 100% local. Zero network. Zero dependencies.
|
|
19
|
+
*/
|
|
20
|
+
|
|
21
|
+
const fs = require('fs');
|
|
22
|
+
const path = require('path');
|
|
23
|
+
const { auditMcp } = require('./mcp-audit');
|
|
24
|
+
const { scanSkills } = require('./skill-scan');
|
|
25
|
+
const { createLogger, verifyEntries } = require('./audit-trail');
|
|
26
|
+
const { createSession, recordEvent, analyzeSession } = require('./behavior');
|
|
27
|
+
const { coverageReport, coverageSummary } = require('./owasp-agentic');
|
|
28
|
+
const { loadPolicy, describePolicy } = require('./agent-policy');
|
|
29
|
+
const { DEFAULT_AUDIT_FILE } = require('./mcp-firewall');
|
|
30
|
+
|
|
31
|
+
const WEIGHTS = { critical: 25, high: 12, medium: 5, low: 1 };
|
|
32
|
+
const DOMAIN_CAP = 40;
|
|
33
|
+
|
|
34
|
+
function gradeFor(score) {
|
|
35
|
+
if (score <= 9) return 'A';
|
|
36
|
+
if (score <= 24) return 'B';
|
|
37
|
+
if (score <= 44) return 'C';
|
|
38
|
+
if (score <= 69) return 'D';
|
|
39
|
+
return 'F';
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
function levelFor(score) {
|
|
43
|
+
if (score === 0) return 'NONE';
|
|
44
|
+
if (score <= 9) return 'LOW';
|
|
45
|
+
if (score <= 24) return 'MODERATE';
|
|
46
|
+
if (score <= 44) return 'ELEVATED';
|
|
47
|
+
if (score <= 69) return 'HIGH';
|
|
48
|
+
return 'CRITICAL';
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
function scoreFindings(findings) {
|
|
52
|
+
let raw = 0;
|
|
53
|
+
const counts = { critical: 0, high: 0, medium: 0, low: 0 };
|
|
54
|
+
for (const f of findings || []) {
|
|
55
|
+
const sev = counts[f.severity] === undefined ? 'low' : f.severity;
|
|
56
|
+
counts[sev]++;
|
|
57
|
+
raw += WEIGHTS[sev] || 1;
|
|
58
|
+
}
|
|
59
|
+
return { raw, capped: Math.min(DOMAIN_CAP, raw), counts };
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
function analyzeAuditLog(file) {
|
|
63
|
+
const result = {
|
|
64
|
+
file,
|
|
65
|
+
exists: false,
|
|
66
|
+
entries: 0,
|
|
67
|
+
blocked: 0,
|
|
68
|
+
warned: 0,
|
|
69
|
+
scrubbed: 0,
|
|
70
|
+
poisonedTools: 0,
|
|
71
|
+
resultInjections: 0,
|
|
72
|
+
allowed: 0,
|
|
73
|
+
chainValid: true,
|
|
74
|
+
brokenAt: [],
|
|
75
|
+
behavior: null,
|
|
76
|
+
score: 0,
|
|
77
|
+
reasons: [],
|
|
78
|
+
};
|
|
79
|
+
let logger;
|
|
80
|
+
try {
|
|
81
|
+
if (!fs.existsSync(file)) return result;
|
|
82
|
+
logger = createLogger(file);
|
|
83
|
+
} catch (err) {
|
|
84
|
+
result.reasons.push(`Audit log could not be read: ${err.message}`);
|
|
85
|
+
return result;
|
|
86
|
+
}
|
|
87
|
+
result.exists = true;
|
|
88
|
+
const entries = logger.entries;
|
|
89
|
+
result.entries = entries.length;
|
|
90
|
+
const verification = verifyEntries(entries);
|
|
91
|
+
result.chainValid = verification.valid;
|
|
92
|
+
result.brokenAt = verification.brokenAt;
|
|
93
|
+
|
|
94
|
+
const session = createSession();
|
|
95
|
+
for (const entry of entries) {
|
|
96
|
+
const detail = entry.detail || {};
|
|
97
|
+
if (entry.type === 'mcp_blocked') {
|
|
98
|
+
result.blocked++;
|
|
99
|
+
recordEvent(session, 'blocked', { tool: detail.tool, server: detail.server });
|
|
100
|
+
} else if (entry.type === 'mcp_warn') {
|
|
101
|
+
result.warned++;
|
|
102
|
+
recordEvent(session, 'network', { tool: detail.tool, server: detail.server });
|
|
103
|
+
} else if (entry.type === 'mcp_result_scrubbed') {
|
|
104
|
+
result.scrubbed++;
|
|
105
|
+
recordEvent(session, 'secret_access', { redactions: detail.redactions });
|
|
106
|
+
} else if (entry.type === 'mcp_tool_poisoned') {
|
|
107
|
+
result.poisonedTools++;
|
|
108
|
+
recordEvent(session, 'tamper', { tool: detail.tool, server: detail.server });
|
|
109
|
+
} else if (entry.type === 'mcp_result_injection') {
|
|
110
|
+
result.resultInjections++;
|
|
111
|
+
recordEvent(session, 'tamper', { patterns: detail.patterns });
|
|
112
|
+
} else if (entry.type === 'mcp_call') {
|
|
113
|
+
result.allowed++;
|
|
114
|
+
recordEvent(session, 'file_read', { tool: detail.tool, server: detail.server });
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
result.behavior = analyzeSession(session);
|
|
118
|
+
result.score =
|
|
119
|
+
Math.min(30, result.blocked * 6) +
|
|
120
|
+
Math.min(30, result.poisonedTools * 15) +
|
|
121
|
+
Math.min(10, result.warned * 1) +
|
|
122
|
+
Math.min(10, result.scrubbed * 2) +
|
|
123
|
+
Math.min(20, result.behavior.patterns.reduce((sum, p) => sum + (p.severity === 'critical' ? 20 : p.severity === 'high' ? 10 : 4), 0));
|
|
124
|
+
if (!result.chainValid) {
|
|
125
|
+
result.score += 15;
|
|
126
|
+
result.reasons.push(`Audit chain is broken at entries ${result.brokenAt.join(', ')} — the log was edited or truncated.`);
|
|
127
|
+
}
|
|
128
|
+
if (result.blocked > 0) result.reasons.push(`${result.blocked} tool call(s) blocked at runtime.`);
|
|
129
|
+
if (result.poisonedTools > 0) result.reasons.push(`${result.poisonedTools} poisoned tool definition(s) removed from tools/list.`);
|
|
130
|
+
if (result.behavior && result.behavior.patternsCount > 0) {
|
|
131
|
+
result.reasons.push(`Behavior anomalies: ${result.behavior.patterns.map((p) => p.pattern).join(', ')}.`);
|
|
132
|
+
}
|
|
133
|
+
result.score = Math.min(DOMAIN_CAP, result.score);
|
|
134
|
+
return result;
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
// Main entry.
|
|
138
|
+
// opts: { auditFile, policyPath, skillPaths, noWrite, frameworks }
|
|
139
|
+
function computeAgentRisk(root, opts = {}) {
|
|
140
|
+
const projectRoot = path.resolve(root || process.cwd());
|
|
141
|
+
const config = auditMcp(projectRoot, { noWrite: opts.noWrite !== false });
|
|
142
|
+
const skills = scanSkills(projectRoot, { paths: opts.skillPaths });
|
|
143
|
+
const auditFile = path.resolve(projectRoot, opts.auditFile || DEFAULT_AUDIT_FILE);
|
|
144
|
+
const runtime = analyzeAuditLog(auditFile);
|
|
145
|
+
const policyState = loadPolicy(projectRoot, opts.policyPath);
|
|
146
|
+
|
|
147
|
+
const configScore = scoreFindings(config.findings);
|
|
148
|
+
const skillScore = scoreFindings(skills.findings);
|
|
149
|
+
|
|
150
|
+
// A policy is not required, but running on defaults means every unknown tool
|
|
151
|
+
// is trusted. That is a real (if small) amount of unmanaged agency.
|
|
152
|
+
let policyScore = 0;
|
|
153
|
+
const policyReasons = [];
|
|
154
|
+
if (policyState.error) {
|
|
155
|
+
policyScore += 15;
|
|
156
|
+
policyReasons.push(policyState.error);
|
|
157
|
+
} else if (!policyState.source) {
|
|
158
|
+
policyScore += 6;
|
|
159
|
+
policyReasons.push('No explicit MCP policy file — running on built-in defaults (unknown tools allowed).');
|
|
160
|
+
}
|
|
161
|
+
if (policyState.policy && policyState.policy.blockExternalNetwork !== true && (policyState.policy.allowedHosts || []).length === 0) {
|
|
162
|
+
policyScore += 3;
|
|
163
|
+
policyReasons.push('Egress is not allowlisted (allowedHosts is empty).');
|
|
164
|
+
}
|
|
165
|
+
policyScore = Math.min(10, policyScore);
|
|
166
|
+
|
|
167
|
+
let auditScore = 0;
|
|
168
|
+
const auditReasons = [];
|
|
169
|
+
if (!runtime.exists) {
|
|
170
|
+
auditScore += 4;
|
|
171
|
+
auditReasons.push('No MCP firewall audit log yet — runtime decisions are not being recorded.');
|
|
172
|
+
} else if (!runtime.chainValid) {
|
|
173
|
+
auditScore += 15;
|
|
174
|
+
}
|
|
175
|
+
auditScore = Math.min(15, auditScore);
|
|
176
|
+
|
|
177
|
+
// Domain caps: config and skills can each dominate; runtime is capped lower
|
|
178
|
+
// so a noisy day does not automatically make the deployment an F.
|
|
179
|
+
const domains = {
|
|
180
|
+
config: { score: configScore.capped, raw: configScore.raw, counts: configScore.counts, findings: config.findings.length },
|
|
181
|
+
skills: { score: skillScore.capped, raw: skillScore.raw, counts: skillScore.counts, findings: skills.findings.length },
|
|
182
|
+
runtime: { score: runtime.score, counts: { blocked: runtime.blocked, warned: runtime.warned, scrubbed: runtime.scrubbed, poisoned: runtime.poisonedTools }, anomalies: runtime.behavior ? runtime.behavior.patterns : [] },
|
|
183
|
+
policy: { score: policyScore, source: policyState.source, error: policyState.error, reasons: policyReasons },
|
|
184
|
+
audit: { score: auditScore, file: auditFile, exists: runtime.exists, entries: runtime.entries, chainValid: runtime.chainValid, reasons: auditReasons },
|
|
185
|
+
};
|
|
186
|
+
|
|
187
|
+
const weighted =
|
|
188
|
+
domains.config.score * 0.35 +
|
|
189
|
+
domains.skills.score * 0.30 +
|
|
190
|
+
domains.runtime.score * 0.20 +
|
|
191
|
+
domains.policy.score * 0.10 +
|
|
192
|
+
domains.audit.score * 0.05;
|
|
193
|
+
// The domain caps sum to 35.75, not 100. Normalize so "everything maxed"
|
|
194
|
+
// reads as 100 and the grade scale means what it says.
|
|
195
|
+
const score = Math.min(100, Math.round((weighted / 35.75) * 100));
|
|
196
|
+
|
|
197
|
+
const allFindings = [...config.findings, ...skills.findings];
|
|
198
|
+
const owasp = coverageReport({ frameworks: opts.frameworks, findings: allFindings });
|
|
199
|
+
|
|
200
|
+
const top = allFindings
|
|
201
|
+
.slice()
|
|
202
|
+
.sort((a, b) => (WEIGHTS[b.severity] || 1) - (WEIGHTS[a.severity] || 1))
|
|
203
|
+
.slice(0, 8)
|
|
204
|
+
.map((f) => ({
|
|
205
|
+
severity: f.severity,
|
|
206
|
+
source: f.server ? 'mcp' : 'skill',
|
|
207
|
+
id: f.id || f.ruleId,
|
|
208
|
+
where: f.server || f.file,
|
|
209
|
+
message: f.message,
|
|
210
|
+
}));
|
|
211
|
+
|
|
212
|
+
return {
|
|
213
|
+
generatedAt: new Date().toISOString(),
|
|
214
|
+
root: projectRoot,
|
|
215
|
+
score,
|
|
216
|
+
grade: gradeFor(score),
|
|
217
|
+
level: levelFor(score),
|
|
218
|
+
domains,
|
|
219
|
+
mcp: { servers: config.servers.length, findings: config.findings, counts: config.counts },
|
|
220
|
+
skills: { scanned: skills.scannedFiles, findings: skills.findings, counts: skills.counts, grade: skills.grade },
|
|
221
|
+
runtime,
|
|
222
|
+
policy: { source: policyState.source, error: policyState.error, summary: describePolicy(policyState.policy, policyState.source) },
|
|
223
|
+
owasp: { percent: owasp.percent, covered: owasp.totalCovered, total: owasp.totalItems, summary: coverageSummary(owasp), report: owasp },
|
|
224
|
+
top,
|
|
225
|
+
reasons: [...runtime.reasons, ...policyReasons, ...auditReasons],
|
|
226
|
+
};
|
|
227
|
+
}
|
|
228
|
+
|
|
229
|
+
function renderAgentRisk(report) {
|
|
230
|
+
const C = { red: '\x1b[31m', green: '\x1b[32m', yellow: '\x1b[33m', cyan: '\x1b[36m', dim: '\x1b[2m', bold: '\x1b[1m', reset: '\x1b[0m' };
|
|
231
|
+
const color = report.grade === 'A' ? C.green : report.grade === 'B' ? C.green : report.grade === 'C' ? C.yellow : C.red;
|
|
232
|
+
const lines = [
|
|
233
|
+
`${C.bold}VibeGuard Agent Risk Score${C.reset}`,
|
|
234
|
+
`${C.dim}${'─'.repeat(64)}${C.reset}`,
|
|
235
|
+
'',
|
|
236
|
+
` Score: ${color}${report.score}/100${C.reset} (${report.level})`,
|
|
237
|
+
` Grade: ${color}${report.grade}${C.reset}`,
|
|
238
|
+
` OWASP: ${report.owasp.covered}/${report.owasp.total} controls mapped (${report.owasp.percent}%)`,
|
|
239
|
+
'',
|
|
240
|
+
`${C.bold}Domains${C.reset}`,
|
|
241
|
+
` MCP config ${String(report.domains.config.score).padStart(3)}/40 ${report.mcp.servers} server(s), ${report.mcp.findings.length} finding(s)`,
|
|
242
|
+
` Skills ${String(report.domains.skills.score).padStart(3)}/40 ${report.skills.scanned} file(s), ${report.skills.findings.length} finding(s)`,
|
|
243
|
+
` Runtime ${String(report.domains.runtime.score).padStart(3)}/40 ${report.runtime.blocked} blocked, ${report.runtime.poisonedTools} poisoned tool(s), ${report.runtime.scrubbed} redaction(s)`,
|
|
244
|
+
` Policy ${String(report.domains.policy.score).padStart(3)}/10 ${report.policy.source || 'built-in defaults'}`,
|
|
245
|
+
` Audit ${String(report.domains.audit.score).padStart(3)}/15 ${report.domains.audit.exists ? `${report.domains.audit.entries} entries, chain ${report.domains.audit.chainValid ? 'intact' : 'BROKEN'}` : 'not recording'}`,
|
|
246
|
+
'',
|
|
247
|
+
];
|
|
248
|
+
if (report.top.length > 0) {
|
|
249
|
+
lines.push(`${C.bold}Top Risks${C.reset}`, '');
|
|
250
|
+
for (const f of report.top) {
|
|
251
|
+
const sc = f.severity === 'critical' ? C.red : f.severity === 'high' ? C.yellow : C.dim;
|
|
252
|
+
lines.push(` ${sc}[${f.severity}]${C.reset} ${f.id} — ${f.where}`);
|
|
253
|
+
lines.push(` ${String(f.message).slice(0, 130)}`);
|
|
254
|
+
}
|
|
255
|
+
lines.push('');
|
|
256
|
+
}
|
|
257
|
+
if (report.reasons.length > 0) {
|
|
258
|
+
lines.push(`${C.bold}Signals${C.reset}`, '');
|
|
259
|
+
for (const r of report.reasons) lines.push(` ${C.yellow}•${C.reset} ${r}`);
|
|
260
|
+
lines.push('');
|
|
261
|
+
}
|
|
262
|
+
const recommendation =
|
|
263
|
+
report.grade === 'A' ? 'Agent posture is clean. Keep the firewall in the loop.' :
|
|
264
|
+
report.grade === 'B' ? 'Minor exposure. Tighten the policy before adding more tools.' :
|
|
265
|
+
report.grade === 'C' ? 'Review the MCP servers and skills named above before the next agent run.' :
|
|
266
|
+
'Do not run this agent unattended until the critical findings are resolved.';
|
|
267
|
+
lines.push(`${C.bold}Recommendation${C.reset}`, ` ${recommendation}`);
|
|
268
|
+
return lines.join('\n');
|
|
269
|
+
}
|
|
270
|
+
|
|
271
|
+
module.exports = { computeAgentRisk, renderAgentRisk, analyzeAuditLog, gradeFor, levelFor, scoreFindings };
|