@rainy-updates/cli 0.5.2-rc.1 → 0.5.2

package/CHANGELOG.md

@@ -2,6 +2,83 @@
 
 All notable changes to this project are documented in this file.
 
+## [0.5.2] - 2026-03-01
+
+### Added
+
+- **New `review` command**: Aggregates pending updates with security, peer-conflict, license, health, and unused-dependency signals for guided dependency review.
+  - `--interactive` launches the upgraded Ink review TUI.
+  - `--security-only`, `--risk <level>`, and `--diff <level>` filter the review set.
+  - `--apply-selected` can apply the filtered/selected updates after review.
+- **New `doctor` command**: Produces a fast dependency verdict for local triage and CI summaries.
+  - Verdict classes: `safe`, `review`, `blocked`, `actionable`.
+  - `--verdict-only` prints a one-line CI-friendly summary.
+- **Interactive review TUI overhaul**:
+  - multi-pane layout with filters, selection state, detail panel, and status bar,
+  - risk/security/peer/license context inline per package,
+  - explicit selection controls for interactive upgrade review.
+- **Additive output contract metadata**:
+  - summary fields: `verdict`, `riskPackages`, `securityPackages`, `peerConflictPackages`, `licenseViolationPackages`, `interactiveSession`,
+  - GitHub outputs: `verdict`, `risk_packages`, `security_packages`, `peer_conflict_packages`, `license_violation_packages`,
+  - SARIF result properties for impact/risk/advisory/license context.
+- **New display controls**:
+  - `--interactive`
+  - `--show-impact`
+  - `--show-homepage`
+- **RC3 hardening layer on top of GA surfaces**:
+  - centralized classified error taxonomy in `src/core/errors.ts`,
+  - compatibility coverage for scoped private registries and cache backend fallback,
+  - explicit cache fallback reason reporting for SQLite → file cache degradation,
+  - dedicated performance scenarios for `check`, `resolve`, and `ci`,
+  - new comparison document: `docs/why-rainy-vs-dependabot-renovate.md`.
+
+### Changed
+
+- `check` now computes impact scores in the core pipeline and carries homepage metadata when available.
+- `upgrade --interactive` now routes through the guided review flow before applying selected updates.
+- CLI help and package exports now cover the new review/verdict surfaces.
+- `doctor` output now follows the RC3 quick-verdict shape:
+  - `State`
+  - `PrimaryRisk`
+  - `NextAction`
+- `check`, `warm-cache`, and `audit` now emit RC3-style classified warnings/errors for:
+  - registry failures,
+  - auth failures,
+  - advisory-source degradation/outage,
+  - cache backend fallback.
+
+### Tests
+
+- Added compatibility tests for:
+  - scoped `.npmrc` private registry resolution,
+  - forced cache backend fallback behavior.
+- Updated audit coverage to assert the new classified advisory degradation warning format.
+
+## [0.5.2-rc.2] - 2026-02-27
+
+### Added
+
+- **Audit RC2 overhaul**:
+  - `audit --summary` / `audit --report summary` groups noisy advisory lists into affected-package summaries.
+  - `audit --source auto|osv|github|all` adds multi-source security lookups, with `auto` querying **OSV.dev + GitHub Advisory Database** and merging results.
+  - Lockfile-backed version inference for `package-lock.json`, `npm-shrinkwrap.json`, `pnpm-lock.yaml`, and basic `bun.lock` workspace entries resolves real installed versions for complex ranges.
+  - JSON audit output now includes package summaries, source metadata, and resolution statistics.
+  - Source-health reporting now distinguishes `ok`, `partial`, and `failed` advisory backends so partial coverage is explicit instead of silent.
+- **Interactive TUI Engine**: An `ink`-based Terminal User Interface for interactive dependency updates, featuring semantic diff coloring and keyboard navigation (`src/ui/tui.tsx`).
+- **Changelog Fetcher**: Implemented `changelog/fetcher.ts` to retrieve release notes dynamically from GitHub API.
+  - Utilizes `bun:sqlite` backed `VersionCache` to prevent API rate limit (403) errors.
+  - Strictly lazy-loaded to preserve zero-overhead startup time.
+
+### Fixed
+
+- Audit patch planning now chooses the lowest safe patched version that clears all detected vulnerable ranges, avoiding unnecessary major jumps during `audit --fix`.
+- Audit findings now record the current installed version and contributing advisory sources per finding.
+- Audit now warns when one advisory source degrades and fails the run when all selected advisory sources are unavailable.
+- Audit terminal output now shows advisory-source health directly in table and summary modes, so degraded coverage is visible without reading JSON.
+- Resolved TypeScript JSX compiler errors by properly exposing `"jsx": "react-jsx"` in `tsconfig.json`.
+
+---
+
 ## [0.5.2] - 2026-02-27
 
 ### Added

package/README.md

@@ -4,6 +4,9 @@ The fastest DevOps-first dependency CLI. Checks, audits, upgrades, bisects, and
 
 `@rainy-updates/cli` is built for teams that need fast dependency intelligence, security auditing, policy-aware upgrades, and automation-ready output for CI/CD and pull request workflows.
 
+Comparison:
+[Why Rainy vs Dependabot and Renovate](./docs/why-rainy-vs-dependabot-renovate.md)
+
 ## Why this package
 
 - Detects updates quickly across single-package repos and workspaces.
@@ -56,10 +59,12 @@ npx @rainy-updates/cli ci --workspace --mode strict
 - `ci` — run CI-focused dependency automation (warm cache, check/upgrade, policy gates)
 - `warm-cache` — prefetch package metadata for fast and offline checks
 - `baseline` — save and compare dependency baseline snapshots
+- `review` — guided review across updates, security, peer conflicts, licenses, and risk
+- `doctor` — fast verdict command for local triage and CI summaries
 
 ### Security & health (_new in v0.5.1_)
 
-- `audit` — scan dependencies for CVEs using [OSV.dev](https://osv.dev) (Google's open vulnerability database)
+- `audit` — scan dependencies for CVEs using [OSV.dev](https://osv.dev) plus GitHub Advisory Database, with lockfile-aware version inference
 - `health` — detect stale, deprecated, and unmaintained packages before they become liabilities
 - `bisect` — binary-search across semver versions to find the exact version that broke your tests
 
@@ -99,9 +104,13 @@ npx @rainy-updates/cli baseline --check --file .artifacts/deps-baseline.json --w
 # 8) Scan for known CVEs  ── NEW in v0.5.1
 npx @rainy-updates/cli audit
 npx @rainy-updates/cli audit --severity high
+npx @rainy-updates/cli audit --summary
+npx @rainy-updates/cli audit --source osv
 npx @rainy-updates/cli audit --fix          # prints the patching npm install command
 rup audit --severity high                   # if installed
 
+`audit` prefers npm/pnpm lockfiles today for exact installed-version inference, and now also reads simple `bun.lock` workspace entries when available. It reports source-health warnings when OSV or GitHub returns only partial coverage.
+
 # 9) Check dependency maintenance health  ── NEW in v0.5.1
 npx @rainy-updates/cli health
 npx @rainy-updates/cli health --stale 6m   # flag packages with no release in 6 months
@@ -113,6 +122,15 @@ npx @rainy-updates/cli bisect axios --cmd "bun test"
 npx @rainy-updates/cli bisect react --range "18.0.0..19.0.0" --cmd "npm test"
 npx @rainy-updates/cli bisect lodash --cmd "npm run test:unit" --dry-run
 rup bisect axios --cmd "bun test"           # if installed
+
+# 11) Review updates with risk and security context  ── NEW in v0.5.2 GA
+npx @rainy-updates/cli review --security-only
+rup review --interactive
+rup review --risk high --diff major
+
+# 12) Get a fast dependency verdict for CI or local triage  ── NEW in v0.5.2 GA
+npx @rainy-updates/cli doctor
+rup doctor --verdict-only
 ```
 
 ## What it does in production
@@ -125,6 +143,7 @@ rup bisect axios --cmd "bun test"           # if installed
 - Supports explicit registry retry/timeout tuning (`--registry-retries`, `--registry-timeout-ms`).
 - Supports stale-cache fallback when registry calls fail.
 - Supports streamed progress output for long CI runs (`--stream`).
+- Exposes impact/risk metadata and homepage context in update output (`--show-impact`, `--show-homepage`).
 
 ### Workspace support
 
@@ -225,6 +244,9 @@ Schedule:
 - `--cooldown-days <n>`
 - `--pr-limit <n>`
 - `--only-changed`
+- `--interactive`
+- `--show-impact`
+- `--show-homepage`
 - `--mode minimal|strict|enterprise` (for `ci`)
 - `--fix-pr-batch-size <n>` (for batched fix branches in `ci`)
 - `--policy-file <path>`
@@ -247,6 +269,17 @@ Schedule:
 - `--pm auto|npm|pnpm`
 - `--sync`
 
+### Review-only
+
+- `--security-only`
+- `--risk critical|high|medium|low`
+- `--diff patch|minor|major|latest`
+- `--apply-selected`
+
+### Doctor-only
+
+- `--verdict-only`
+
 ### Baseline-only
 
 - `--save`

package/dist/bin/cli.js

@@ -111,6 +111,39 @@ async function main() {
             process.exitCode = result.errors.length > 0 ? 1 : 0;
             return;
         }
+        if (parsed.command === "review") {
+            const { runReview } = await import("../commands/review/runner.js");
+            const result = await runReview(parsed.options);
+            process.exitCode =
+                result.summary.verdict === "blocked" ||
+                    result.summary.verdict === "actionable" ||
+                    result.summary.verdict === "review"
+                    ? 1
+                    : 0;
+            return;
+        }
+        if (parsed.command === "doctor") {
+            const { runDoctor } = await import("../commands/doctor/runner.js");
+            const result = await runDoctor(parsed.options);
+            process.exitCode = result.verdict === "safe" ? 0 : 1;
+            return;
+        }
+        if (parsed.options.interactive &&
+            (parsed.command === "check" ||
+                parsed.command === "upgrade" ||
+                parsed.command === "ci")) {
+            const { runReview } = await import("../commands/review/runner.js");
+            const result = await runReview({
+                ...parsed.options,
+                securityOnly: false,
+                risk: undefined,
+                diff: undefined,
+                applySelected: parsed.command === "upgrade",
+            });
+            process.exitCode =
+                result.summary.verdict === "safe" && result.updates.length === 0 ? 0 : 1;
+            return;
+        }
         const result = await runCommand(parsed);
         if (parsed.options.fixPr &&
             (parsed.command === "check" ||
@@ -148,11 +181,17 @@ async function main() {
         }
         result.summary.failReason = resolveFailReason(result.updates, result.errors, parsed.options.failOn, parsed.options.maxUpdates, parsed.options.ci);
         const renderStartedAt = Date.now();
-        let rendered = renderResult(result, parsed.options.format);
+        let rendered = renderResult(result, parsed.options.format, {
+            showImpact: parsed.options.showImpact,
+            showHomepage: parsed.options.showHomepage,
+        });
         result.summary.durationMs.render = Math.max(0, Date.now() - renderStartedAt);
         if (parsed.options.format === "json" ||
             parsed.options.format === "metrics") {
-            rendered = renderResult(result, parsed.options.format);
+            rendered = renderResult(result, parsed.options.format, {
+                showImpact: parsed.options.showImpact,
+                showHomepage: parsed.options.showHomepage,
+            });
         }
         if (parsed.options.onlyChanged &&
             result.updates.length === 0 &&
@@ -220,6 +259,9 @@ Options:
   --cooldown-days <n>
   --pr-limit <n>
   --only-changed
+  --interactive
+  --show-impact
+  --show-homepage
   --lockfile-mode preserve|update|error
   --log-level error|warn|info|debug
   --ci`;
@@ -267,6 +309,7 @@ Options:
   --fix-dry-run
   --fix-pr-no-checkout
   --fix-pr-batch-size <n>
+  --interactive
   --lockfile-mode preserve|update|error
   --no-pr-report
   --json-file <path>
@@ -330,6 +373,53 @@ Options:
   --workspace
   --dep-kinds deps,dev,optional,peer
   --ci`;
+    }
+    if (isCommand && command === "audit") {
+        return `rainy-updates audit [options]
+
+Scan dependencies for CVEs using OSV.dev and GitHub Advisory Database.
+
+Options:
+  --workspace
+  --severity critical|high|medium|low
+  --summary
+  --report table|summary|json
+  --source auto|osv|github|all
+  --fix
+  --dry-run
+  --commit
+  --pm auto|npm|pnpm|bun|yarn
+  --json-file <path>
+  --concurrency <n>
+  --registry-timeout-ms <n>`;
+    }
+    if (isCommand && command === "review") {
+        return `rainy-updates review [options]
+
+Review updates with risk, security, peer, and policy context.
+
+Options:
+  --workspace
+  --interactive
+  --security-only
+  --risk critical|high|medium|low
+  --diff patch|minor|major|latest
+  --apply-selected
+  --policy-file <path>
+  --json-file <path>
+  --concurrency <n>
+  --registry-timeout-ms <n>
+  --registry-retries <n>`;
+    }
+    if (isCommand && command === "doctor") {
+        return `rainy-updates doctor [options]
+
+Produce a fast overall dependency verdict.
+
+Options:
+  --workspace
+  --verdict-only
+  --json-file <path>`;
     }
     return `rainy-updates (rup / rainy-up) <command> [options]
 
@@ -340,13 +430,15 @@ Commands:
   warm-cache  Warm local cache for fast/offline checks
   init-ci     Scaffold GitHub Actions workflow
   baseline    Save/check dependency baseline snapshots
-  audit       Scan dependencies for CVEs (OSV.dev)
+  audit       Scan dependencies for CVEs (OSV.dev + GitHub)
   health      Detect stale/deprecated/unmaintained packages
   bisect      Find which version of a dep introduced a failure
   unused      Detect unused or missing npm dependencies
   resolve     Check peer dependency conflicts (pure-TS, no subprocess)
   licenses    Scan dependency licenses and generate SPDX SBOM
   snapshot    Save, list, restore, and diff dependency state snapshots
+  review      Guided dependency review with risk/security context
+  doctor      Fast dependency verdict for local or CI use
 
 Global options:
   --cwd <path>
@@ -365,6 +457,9 @@ Global options:
   --cooldown-days <n>
   --pr-limit <n>
   --only-changed
+  --interactive
+  --show-impact
+  --show-homepage
   --mode minimal|strict|enterprise
   --fix-pr
   --fix-branch <name>
@@ -386,6 +481,36 @@ Global options:
   --version, -v`;
 }
 async function runCommand(parsed) {
+    if (parsed.command === "review") {
+        const { runReview } = await import("../commands/review/runner.js");
+        const result = await runReview(parsed.options);
+        return {
+            projectPath: result.projectPath,
+            packagePaths: result.items.map((item) => item.update.packagePath),
+            packageManager: "unknown",
+            target: result.target,
+            timestamp: new Date().toISOString(),
+            summary: result.summary,
+            updates: result.updates,
+            errors: result.errors,
+            warnings: result.warnings,
+        };
+    }
+    if (parsed.command === "doctor") {
+        const { runDoctor } = await import("../commands/doctor/runner.js");
+        const result = await runDoctor(parsed.options);
+        return {
+            projectPath: result.review.projectPath,
+            packagePaths: result.review.items.map((item) => item.update.packagePath),
+            packageManager: "unknown",
+            target: result.review.target,
+            timestamp: new Date().toISOString(),
+            summary: result.summary,
+            updates: result.review.updates,
+            errors: result.review.errors,
+            warnings: result.review.warnings,
+        };
+    }
     if (parsed.command === "upgrade") {
         return await upgrade(parsed.options);
     }

package/dist/cache/cache.d.ts

@@ -3,6 +3,7 @@ export declare class VersionCache {
     private readonly store;
     readonly backend: "sqlite" | "file";
     readonly degraded: boolean;
+    readonly fallbackReason?: string;
     private constructor();
     static create(customPath?: string): Promise<VersionCache>;
     getValid(packageName: string, target: TargetLevel): Promise<CachedVersion | null>;

package/dist/cache/cache.js

@@ -1,6 +1,7 @@
 import { promises as fs } from "node:fs";
 import os from "node:os";
 import path from "node:path";
+import process from "node:process";
 class FileCacheStore {
     filePath;
     constructor(filePath) {
@@ -108,20 +109,26 @@ export class VersionCache {
     store;
     backend;
     degraded;
-    constructor(store, backend, degraded) {
+    fallbackReason;
+    constructor(store, backend, degraded, fallbackReason) {
         this.store = store;
         this.backend = backend;
         this.degraded = degraded;
+        this.fallbackReason = fallbackReason;
     }
     static async create(customPath) {
         const basePath = customPath ?? path.join(os.homedir(), ".cache", "rainy-updates");
+        if (process.env.RAINY_UPDATES_CACHE_BACKEND === "file") {
+            const jsonPath = path.join(basePath, "cache.json");
+            return new VersionCache(new FileCacheStore(jsonPath), "file", true, "forced via RAINY_UPDATES_CACHE_BACKEND=file");
+        }
         const sqlitePath = path.join(basePath, "cache.db");
         const sqliteStore = await tryCreateSqliteStore(sqlitePath);
         if (sqliteStore)
             return new VersionCache(sqliteStore, "sqlite", false);
         const jsonPath = path.join(basePath, "cache.json");
         const degraded = typeof Bun !== "undefined";
-        return new VersionCache(new FileCacheStore(jsonPath), "file", degraded);
+        return new VersionCache(new FileCacheStore(jsonPath), "file", degraded, degraded ? "bun:sqlite unavailable; using file cache backend" : undefined);
     }
     async getValid(packageName, target) {
         const entry = await this.store.get(packageName, target);

package/dist/commands/audit/fetcher.d.ts

@@ -1,6 +1,2 @@
-import type { CveAdvisory, AuditOptions } from "../../types/index.js";
-/**
- * Fetches CVE advisories for all given package names in parallel.
- * Uses OSV.dev as primary source.
- */
-export declare function fetchAdvisories(packageNames: string[], options: Pick<AuditOptions, "concurrency" | "registryTimeoutMs">): Promise<CveAdvisory[]>;
+export { extractAuditVersion } from "./targets.js";
+export { fetchAdvisoriesFromSources as fetchAdvisories } from "./sources/index.js";

package/dist/commands/audit/fetcher.js

@@ -1,79 +1,2 @@
-import { asyncPool } from "../../utils/async-pool.js";
-const OSV_API = "https://api.osv.dev/v1/query";
-const GITHUB_ADVISORY_API = "https://api.github.com/advisories";
-/**
- * Queries OSV.dev for advisories for a single npm package.
- */
-async function queryOsv(packageName, timeoutMs) {
-    const body = JSON.stringify({
-        package: { name: packageName, ecosystem: "npm" },
-    });
-    let response;
-    try {
-        const controller = new AbortController();
-        const timer = setTimeout(() => controller.abort(), timeoutMs);
-        response = await fetch(OSV_API, {
-            method: "POST",
-            headers: { "Content-Type": "application/json" },
-            body,
-            signal: controller.signal,
-        });
-        clearTimeout(timer);
-    }
-    catch {
-        return [];
-    }
-    if (!response.ok)
-        return [];
-    const data = (await response.json());
-    const advisories = [];
-    for (const vuln of data.vulns ?? []) {
-        const cveId = vuln.id ?? "UNKNOWN";
-        const rawSeverity = (vuln.database_specific?.severity ?? "medium").toLowerCase();
-        const severity = (["critical", "high", "medium", "low"].includes(rawSeverity)
-            ? rawSeverity
-            : "medium");
-        let patchedVersion = null;
-        let vulnerableRange = "*";
-        for (const affected of vuln.affected ?? []) {
-            if (affected.package?.name !== packageName)
-                continue;
-            for (const range of affected.ranges ?? []) {
-                const fixedEvent = range.events?.find((e) => e.fixed);
-                if (fixedEvent?.fixed) {
-                    patchedVersion = fixedEvent.fixed;
-                    const introducedEvent = range.events?.find((e) => e.introduced);
-                    vulnerableRange = introducedEvent?.introduced
-                        ? `>=${introducedEvent.introduced} <${patchedVersion}`
-                        : `<${patchedVersion}`;
-                }
-            }
-        }
-        advisories.push({
-            cveId,
-            packageName,
-            severity,
-            vulnerableRange,
-            patchedVersion,
-            title: vuln.summary ?? cveId,
-            url: vuln.references?.[0]?.url ?? `https://osv.dev/vulnerability/${cveId}`,
-        });
-    }
-    return advisories;
-}
-/**
- * Fetches CVE advisories for all given package names in parallel.
- * Uses OSV.dev as primary source.
- */
-export async function fetchAdvisories(packageNames, options) {
-    const tasks = packageNames.map((name) => () => queryOsv(name, options.registryTimeoutMs));
-    const results = await asyncPool(options.concurrency, tasks);
-    const advisories = [];
-    for (const r of results) {
-        if (!(r instanceof Error)) {
-            for (const adv of r)
-                advisories.push(adv);
-        }
-    }
-    return advisories;
-}
+export { extractAuditVersion } from "./targets.js";
+export { fetchAdvisoriesFromSources as fetchAdvisories } from "./sources/index.js";

package/dist/commands/audit/mapper.d.ts

@@ -1,4 +1,4 @@
-import type { CveAdvisory, AuditSeverity } from "../../types/index.js";
+import type { AuditPackageSummary, AuditSourceStatus, CveAdvisory, AuditSeverity } from "../../types/index.js";
 /**
  * Filters advisories by minimum severity level.
  * e.g. --severity high → keeps critical and high.
@@ -8,9 +8,16 @@ export declare function filterBySeverity(advisories: CveAdvisory[], minSeverity:
  * For each advisory that has a known patchedVersion,
  * produces a sorted, deduplicated map of package → minimum secure version.
  * Used by --fix to determine what version to update to.
+ *
+ * Uses proper semver numeric comparison — NOT string comparison — so that
+ * e.g. "5.19.1" correctly beats "5.5.1" (lexicographically "5.5.1" > "5.19.1"
+ * because "5" > "1" at the third character, which is the classic semver trap).
  */
 export declare function buildPatchMap(advisories: CveAdvisory[]): Map<string, string>;
+export declare function summarizeAdvisories(advisories: CveAdvisory[]): AuditPackageSummary[];
 /**
  * Renders audit advisories as a formatted table string for terminal output.
  */
 export declare function renderAuditTable(advisories: CveAdvisory[]): string;
+export declare function renderAuditSummary(packages: AuditPackageSummary[]): string;
+export declare function renderAuditSourceHealth(sourceHealth: AuditSourceStatus[]): string;

package/dist/commands/audit/mapper.js

@@ -1,3 +1,4 @@
+import { compareVersions, parseVersion, satisfies } from "../../utils/semver.js";
 const SEVERITY_RANK = {
     critical: 4,
     high: 3,
@@ -18,19 +19,66 @@ export function filterBySeverity(advisories, minSeverity) {
  * For each advisory that has a known patchedVersion,
  * produces a sorted, deduplicated map of package → minimum secure version.
  * Used by --fix to determine what version to update to.
+ *
+ * Uses proper semver numeric comparison — NOT string comparison — so that
+ * e.g. "5.19.1" correctly beats "5.5.1" (lexicographically "5.5.1" > "5.19.1"
+ * because "5" > "1" at the third character, which is the classic semver trap).
  */
 export function buildPatchMap(advisories) {
     const patchMap = new Map();
+    const byPackage = new Map();
     for (const advisory of advisories) {
-        if (!advisory.patchedVersion)
+        const items = byPackage.get(advisory.packageName) ?? [];
+        items.push(advisory);
+        byPackage.set(advisory.packageName, items);
+    }
+    for (const [packageName, items] of byPackage) {
+        const candidates = [...new Set(items.flatMap((item) => item.patchedVersion ? [item.patchedVersion] : []))].sort(compareSemverAsc);
+        if (candidates.length === 0)
             continue;
-        const existing = patchMap.get(advisory.packageName);
-        if (!existing || advisory.patchedVersion > existing) {
-            patchMap.set(advisory.packageName, advisory.patchedVersion);
-        }
+        const safeCandidate = candidates.find((candidate) => items.every((item) => !satisfies(candidate, item.vulnerableRange)));
+        patchMap.set(packageName, safeCandidate ?? candidates[candidates.length - 1]);
     }
     return patchMap;
 }
+function compareSemverAsc(a, b) {
+    const pa = parseVersion(a);
+    const pb = parseVersion(b);
+    if (pa && pb)
+        return compareVersions(pa, pb);
+    if (a === b)
+        return 0;
+    return a < b ? -1 : 1;
+}
+export function summarizeAdvisories(advisories) {
+    const byPackage = new Map();
+    for (const advisory of advisories) {
+        const key = `${advisory.packageName}|${advisory.currentVersion ?? "?"}`;
+        const items = byPackage.get(key) ?? [];
+        items.push(advisory);
+        byPackage.set(key, items);
+    }
+    const summaries = [];
+    for (const [, items] of byPackage) {
+        const sorted = [...items].sort((a, b) => SEVERITY_RANK[b.severity] - SEVERITY_RANK[a.severity]);
+        const representative = sorted[0];
+        const patchMap = buildPatchMap(items);
+        summaries.push({
+            packageName: representative.packageName,
+            currentVersion: representative.currentVersion,
+            severity: representative.severity,
+            advisoryCount: items.length,
+            patchedVersion: patchMap.get(representative.packageName) ?? null,
+            sources: [...new Set(items.flatMap((item) => item.sources))].sort(),
+        });
+    }
+    return summaries.sort((a, b) => {
+        const severityDiff = SEVERITY_RANK[b.severity] - SEVERITY_RANK[a.severity];
+        if (severityDiff !== 0)
+            return severityDiff;
+        return a.packageName.localeCompare(b.packageName);
+    });
+}
 /**
  * Renders audit advisories as a formatted table string for terminal output.
  */
@@ -47,15 +95,63 @@ export function renderAuditTable(advisories) {
     const sorted = [...advisories].sort((a, b) => SEVERITY_RANK[b.severity] - SEVERITY_RANK[a.severity]);
     const lines = [
         `Found ${advisories.length} ${advisories.length === 1 ? "vulnerability" : "vulnerabilities"}:\n`,
-        "Package".padEnd(30) + "Severity".padEnd(20) + "CVE".padEnd(22) + "Patch",
-        "─".repeat(90),
+        "Package".padEnd(24) +
+            "Current".padEnd(14) +
+            "Severity".padEnd(20) +
+            "CVE".padEnd(22) +
+            "Patch",
+        "─".repeat(104),
     ];
     for (const adv of sorted) {
-        const name = adv.packageName.slice(0, 28).padEnd(30);
+        const name = adv.packageName.slice(0, 22).padEnd(24);
+        const current = (adv.currentVersion ?? "?").slice(0, 12).padEnd(14);
         const sev = SEVERITY_ICON[adv.severity].padEnd(20);
         const cve = adv.cveId.slice(0, 20).padEnd(22);
         const patch = adv.patchedVersion ? `→ ${adv.patchedVersion}` : "no patch";
-        lines.push(`${name}${sev}${cve}${patch}`);
+        lines.push(`${name}${current}${sev}${cve}${patch}`);
+    }
+    return lines.join("\n");
+}
+export function renderAuditSummary(packages) {
+    if (packages.length === 0) {
+        return "✔ No vulnerable packages found.\n";
+    }
+    const SEVERITY_ICON = {
+        critical: "🔴 CRITICAL",
+        high: "🟠 HIGH    ",
+        medium: "🟡 MEDIUM  ",
+        low: "⚪ LOW     ",
+    };
+    const lines = [
+        `Found ${packages.length} affected ${packages.length === 1 ? "package" : "packages"}:\n`,
+        "Package".padEnd(24) +
+            "Current".padEnd(14) +
+            "Severity".padEnd(20) +
+            "Advisories".padEnd(12) +
+            "Patch",
+        "─".repeat(98),
+    ];
+    for (const item of packages) {
+        const name = item.packageName.slice(0, 22).padEnd(24);
+        const current = (item.currentVersion ?? "?").slice(0, 12).padEnd(14);
+        const sev = SEVERITY_ICON[item.severity].padEnd(20);
+        const count = String(item.advisoryCount).padEnd(12);
+        const patch = item.patchedVersion ? `→ ${item.patchedVersion}` : "no patch";
+        lines.push(`${name}${current}${sev}${count}${patch}`);
+    }
+    return lines.join("\n");
+}
+export function renderAuditSourceHealth(sourceHealth) {
+    if (sourceHealth.length === 0)
+        return "";
+    const lines = ["", "Sources:"];
+    for (const item of sourceHealth) {
+        const label = item.source === "osv" ? "OSV.dev" : "GitHub Advisory DB";
+        const status = item.status.toUpperCase().padEnd(7);
+        const coverage = `${item.successfulTargets}/${item.attemptedTargets} targets`;
+        const advisories = `${item.advisoriesFound} advisories`;
+        const suffix = item.message ? ` (${item.message})` : "";
+        lines.push(`  ${label.padEnd(22)} ${status} ${coverage}, ${advisories}${suffix}`);
     }
     return lines.join("\n");
 }