Output Formats

Overview

Vibgrate supports four output formats, each optimized for different workflows and consumers.

Text (Default)

A colored, human-readable report for terminal use:

vg scan

Example Output:

╭─────────────────────────────────────────────╮
│  VIBGRATE DRIFT REPORT                      │
├─────────────────────────────────────────────┤
│  DriftScore: 67/100 (High)                  │
│  Projects: 4 found                          │
│  Findings: 12 (3 errors, 7 warnings)        │
╰─────────────────────────────────────────────╯

📊 Score Breakdown
├─ Runtime:      85/100  ████████░░
├─ Frameworks:   70/100  ███████░░░
├─ Dependencies: 55/100  █████░░░░░
└─ EOL Risk:     90/100  █████████░

🔴 ERROR: Node.js 16.x is EOL
   → Upgrade to Node.js 20.x or 22.x

🟡 WARNING: 45% dependencies 2+ majors behind
   → Review dependency-risk findings

JSON

Full scan artifact with complete data:

vg scan --format json --out scan.json

Example Output:

{
  "schemaVersion": "1.0",
  "meta": {
    "version": "1.0.0",
    "timestamp": "2025-01-15T10:30:00Z",
    "duration": 4520
  },
  "driftScore": 67,
  "scores": {
    "runtime": 85,
    "frameworks": 70,
    "dependencies": 55,
    "eolRisk": 90
  },
  "projects": [
    {
      "path": "./",
      "ecosystem": "nodejs",
      "drift": 45
    }
  ],
  "findings": [
    {
      "id": "nodejs-eol",
      "severity": "error",
      "message": "Node.js 16.x is EOL"
    }
  ]
}

SARIF

Static Analysis Results Interchange Format for CI integration:

vg scan --format sarif --out vibgrate.sarif

Platform Compatibility

GitHub Actions Example

- name: Run Vibgrate
  run: npx @vibgrate/cli scan --format sarif --out vibgrate.sarif

- name: Upload SARIF
  uses: github/codeql-action/upload-sarif@v3
  with:
    sarif_file: vibgrate.sarif

Markdown

Clean, portable report for documentation:

vg scan --format md --out report.md

Example Output:

# Vibgrate Drift Report

**Generated:** 2025-01-15T10:30:00Z
**DriftScore:** 67/100 (High Risk)

## Summary

| Metric | Value |
|--------|-------|
| Projects | 4 |
| Findings | 12 |
| Errors | 3 |

## Top Findings

### 🔴 Node.js 16.x is EOL
**Severity:** Error
**Recommendation:** Upgrade to Node.js 20.x or 22.x

Use Cases

Format Comparison

Related

• vg scan — Output format flags
• vg report — Generate from artifacts
• CI Integration — SARIF upload examples