---
name: security-dashboard
description: Cross-project security dashboard — machine-wide posture overview with per-project grades
---

# Security Dashboard

Machine-wide posture overview. Scans all detected projects, aggregates to a single machine grade (weakest link).

## Step 1: Run Aggregator

```bash
node <plugin-root>/scanners/dashboard-aggregator.mjs [--no-cache]
```

Uses 24h cache by default. Pass `--no-cache` to force fresh scan.

## Step 2: Format Dashboard

Parse JSON: `meta`, `machine.grade` (weakest link), `projects[]`, `errors[]`.

```
# Security Dashboard

| Machine Grade | [A-F] (weakest link) |
| Projects Scanned | N |
| Cached | Yes/No |

## Per-Project Grades

| Project | Grade | Risk Score | Verdict | Last Scan |
|---------|-------|------------|---------|-----------|
[sorted by grade, worst first]

## Errors (if any)

[List projects that failed to scan]
```

## Step 3: Recommendations

- Grade A/B: "Machine posture is strong."
- Grade C: "Review projects with grade C or below."
- Grade D/F: "Significant exposure. Run audit on failing projects."