feat: HTML inventory report generator with Perplexity editorial design

[shrwnsan]

Summary

bumblebee scan produces an inventory.ndjson file, but there is no built-in way to visualize or explore the results in a human-friendly format. This PR adds a self-contained Python script (scripts/generate-report.py) that transforms raw NDJSON output into a rich, interactive HTML report.

What it does

• Reads inventory.ndjson and produces a single self-contained report.html (zero external dependencies, Python 3.10+ stdlib only)
• Presents 7 ordered sections: Ecosystems, Lifecycle Scripts, Version Sprawl, Top Projects, Confidence Scores, Detection Sources, Scan Roots — organized as Overview → Risks → Landscape → Reference
• Renders inline bar charts in table cells for quantitative columns (ecosystem share, version counts, confidence scores)
• Supports dark ("Midnight Parchment") and light ("Perplexity Editorial") themes with smooth transitions and localStorage persistence
• Includes a scroll-spy page outline mini-TOC (fixed right-edge nav) and a scroll progress bar
• Truncates long project paths with ellipsis, expanding on hover — no content flash

Design system

Inspired by the Perplexity blog aesthetic:

Token	Light	Dark
Background	#fbfaf4 (warm cream)	#091717 (deep forest-teal)
Text	#13343b (deep teal-black)	#e6e2d8 (ivory)
Accent	#20808d (teal)	#20808d (teal)
Data viz	#d4940a (amber)	#d4940a (amber)

Fonts: Newsreader (serif display), Outfit (geometric body), JetBrains Mono (data/code).

Files changed

File	Description
scripts/generate-report.py	New — single ~1400-line script, the only deliverable
.gitignore	Added report.html (generated output)

Usage

# Generate the report
python3 scripts/generate-report.py inventory.ndjson -o report.html

# Open in browser
open report.html          # macOS
xdg-open report.html      # Linux

Testing

Tested against a real 7,895-package inventory.ndjson from bumblebee scan across 7 ecosystems (npm, PyPI, Go, Cargo, RubyGems, Maven, NuGet). Verified table alignment and hover behavior in Chrome/Brave on macOS arm64.

Commits

1. 3323fea — feat: add generate-report.py script for inventory.ndjson
2. 61cb55b — style: adopt Perplexity editorial design system
3. 86e515d — fix: proj-cell hover — replace dual-span swap with single trunc element

[shrwnsan]

Draft PR: feat/html-report-script → main

Branch: feat/html-report-script (4 commits ahead of main, tagged v0.2.0)
Target: shrwnsan/bumblebee:main — eventually perplexityai/bumblebee:main

---

PR Title

feat: add HTML inventory report generator with Perplexity editorial design

PR Description

Summary

Adds scripts/generate-report.py — a zero-dependency Python 3.10+ script that reads bumblebee's inventory.ndjson output and produces a single self-contained HTML report with dark/light theming, scroll-spy navigation, and inline data visualization.

Motivation

bumblebee scan generates structured NDJSON, but there is no built-in reporting. Users need to either write custom tooling or parse JSON manually. This script provides an immediate, visually rich overview of scan results — ecosystem distribution, version sprawl, top projects by package count, confidence scores, and detection sources — with zero setup beyond Python 3.

Changes

• New: scripts/generate-report.py (~1400 lines) — the sole deliverable
• Updated: .gitignore — added report.html to exclude generated output

Design decisions

Decision	Rationale
Standalone script, not a Go subcommand	Zero build impact on bumblebee core; Python is universally available
Self-contained HTML (inline CSS/JS)	No web server, no build step — just open in a browser
Perplexity editorial design system	Visual alignment with the parent brand; dark+light modes
7 fixed sections (not configurable)	Opinionated information architecture: Overview → Risks → Landscape → Reference
table-layout: auto (not fixed)	Avoids Chrome/Brave column misalignment with border-radius wrappers
Single-span truncation for project paths	Eliminates hover flash that the dual-span approach caused

Screenshots

(To be added from local testing with 7,895-package inventory)

Testing

• Tested with real inventory.ndjson (7,895 packages, 7 ecosystems)
• Dark/light theme toggle with localStorage persistence
• Scroll-spy page outline shows active section
• Table column alignment verified in Chrome and Brave (macOS arm64)
• Project path hover truncation — no flash or layout shift
• Early-exit guards for empty/missing input files

Checklist

• Code follows project conventions (see CONTRIBUTING.md)
• No new dependencies introduced
• Generated output (report.html) is gitignored
• Ready for upstream submission to perplexityai/bumblebee

[shrwnsan]

Upstream PR is open for review: perplexityai/bumblebee#29

Closing this issue — the feature work is complete and tracking now lives on the upstream PR.