portfolio-reviewlisted

# Portfolio Review Analyse every repository for a GitHub account and produce two deliverables: 1. **`portfolio-review.html`** — interactive dark-themed site with Chart.js graphs (opportunity scatter, ranked-potential bars, top-6 radar, language doughnut, commit distribution), a sortable/filterable scoring table, and a verdict card per project. 2. **`PORTFOLIO_REVIEW.md`** — the same data in portable Markdown. Both are rendered from one JSON data file by the bundled script, so the charts and the Markdown always agree. ## Workflow ### 1. List repositories ```bash gh repo list <username> --limit 200 --json name,description,url,primaryLanguage,isPrivate,stargazerCount,forkCount,pushedAt,diskUsage,createdAt,latestRelease,licenseInfo ``` Omit `<username>` to use the authenticated user. Note the total count. ### 2. Gather evidence per repo You cannot judge potential from metadata alone — read what each project *does*. - **READMEs** (the key signal). Decode with: `gh api "repos/<owner>/<repo>/readme" -q '.content' | base64 -d`. Batch several in one shell call; cap each at ~60 lines. - **Commit count** (a maturity signal): from the `Link` header of `gh api "repos/<owner>/<repo>/commits?per_page=1" -i` (parse `page=N>; rel="last"`), falling back to `gh api ".../commits?per_page=100" -q 'length'`. - **Releases** (already in step 1's `latestRelease`), and for empty repos the API returns a 409/404 — treat as "concept only" (0 commits). - Skip deep-reading tiny/legacy/dormant repos;