feat: release v0.2.0

Author: hsnice16

.claude/settings.json

@@ -6,7 +6,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "printf '\\n📦 Agent Friendly Code — current release: 0.1.0\\n  • Read AGENTS.md for conventions, CONTRIBUTING.md for the PR workflow.\\n  • Roadmap: 0.2.0 (dogfood) → 0.3.0 (benchmark harness) → 0.4.0 (ecosystem integration) → 0.5.0 (alternatives) → 0.6.0 (registry overlay) → 0.7.0 (history-aware signals) → 1.0.0 (production stability) → 1.1.0 (at-scale GitHub indexing).\\n  • Changelog rule: user-facing capabilities only. Codebase hygiene (CI / linter / tests / CONTRIBUTING) does NOT go in lib/changelog.ts.\\n'"
+            "command": "printf '\\n📦 Agent Friendly Code — current release: 0.2.0\\n  • Read AGENTS.md for conventions, CONTRIBUTING.md for the PR workflow.\\n  • Roadmap: 0.3.0 (benchmark harness) → 0.4.0 (ecosystem integration) → 0.5.0 (alternatives) → 0.6.0 (registry overlay) → 0.7.0 (history-aware signals) → 1.0.0 (production stability) → 1.1.0 (at-scale GitHub indexing).\\n  • Changelog rule: user-facing capabilities only. Codebase hygiene (CI / linter / tests / CONTRIBUTING) does NOT go in lib/changelog.ts.\\n'"
           }
         ]
       }

.github/PULL_REQUEST_TEMPLATE.md

@@ -14,7 +14,7 @@ _Bulleted list of what this PR modifies. Keep it scoped to the summary._
 
 ## Testing
 
-_How you verified this. Commands run (`bun run score <url>`, `bun x tsc --noEmit`, manual pass of specific pages). For UI changes: mobile + desktop, light + dark._
+_How you verified this. Commands run (`bun run test`, `bun run score <url>`, `bun x tsc --noEmit`, manual pass of specific pages). For UI changes: mobile + desktop, light + dark._
 
 ## Screenshots / screencasts
 

.github/workflows/ci.yml

@@ -12,7 +12,7 @@ concurrency:
 
 jobs:
   check:
-    name: Lint · Format · Typecheck
+    name: Lint · Format · Typecheck · Test
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
@@ -22,6 +22,11 @@ jobs:
         with:
           bun-version: 1.2.16
 
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+
       - name: Install
         run: bun install --frozen-lockfile
 
@@ -30,3 +35,6 @@ jobs:
 
       - name: Typecheck
         run: bun x tsc --noEmit
+
+      - name: Test
+        run: bun run test

.nvmrc

@@ -0,0 +1 @@
+22

AGENTS.md

@@ -27,11 +27,12 @@ See `README.md` for the full product narrative. See `tasks/` for per-version wor
 
 ```bash
 bun install
-bun run prepare-hooks  # once — installs lefthook git hooks (Biome + tsc on pre-commit)
+bun run prepare-hooks  # once — installs lefthook git hooks (Biome + tsc + test on pre-commit)
 bun run init-db        # optional — auto-runs on first score
-bun run seed           # score the curated set (~42 repos) across GH / GL / BB
+bun run seed           # score the curated set (124 repos) across GH / GL / BB
 bun run dev            # http://localhost:3000
 bun run score <url>    # score a single repo
+bun run test           # unit tests (node --test + tsx) — requires Node ≥20.9.0
 ```
 
 ## Layout
@@ -54,7 +55,7 @@ components/               # Tailwind-styled React components
   HostPill.tsx, HostSelect.tsx, Medal.tsx, ModelPills.tsx,
   MobileNav.tsx, Pagination.tsx, SearchBar.tsx, SelectMenu.tsx, SortSelect.tsx,
   SignalRow.tsx, SuggestionItem.tsx, VersionPill.tsx,
-  GoogleAnalytics.tsx
+  BackToTop.tsx, GoogleAnalytics.tsx
 lib/
   constants/
     scoring.ts            # score thresholds, visible limits
@@ -75,10 +76,16 @@ lib/
   roadmap.ts              # typed RoadmapVersion[]
 scripts/
   init-db.ts, score.ts, seed.ts
+tests/
+  _helpers.ts             # makeFixture / removeFixture build synthetic trees under os.tmpdir()
+  format.test.ts          # compactStars, relativeTime, hostLabel
+  parse-repo-url.test.ts  # GH / GL / BB parsing + edge cases
+  scorer.test.ts          # scoreRepo, topImprovements
+  signals/                # one *.test.ts per signal
 tasks/
   README.md
   0.1.0/                  # released — shipped record
-  0.2.0/                  # planned — complete the dogfood
+  0.2.0/                  # released — dogfood complete (tests, self-score, row-click)
   0.3.0/                  # planned — real per-model weights (benchmark harness)
   0.4.0/                  # planned — ecosystem integration (badge, PR diff, webhook, opt-out)
   0.5.0/                  # planned — discovery (alternative recommender)
@@ -184,6 +191,7 @@ Hooks docs: <https://docs.claude.com/en/docs/claude-code/hooks.html>.
 ## Useful pre-commit checks
 
 - `bun run score https://github.com/honojs/hono` — end-to-end smoke.
+- `bun run test` — unit tests (Node ≥20.9.0 required).
 - `curl -s localhost:3000/api/repos | head` — verify persistence + API.
 - `bun x tsc --noEmit` — typecheck.
 - Manual pass over `/`, `/repo/:id`, `/methodology`, `/roadmap`, `/changelog` after UI changes.

CONTRIBUTING.md

@@ -8,9 +8,10 @@ Read [AGENTS.md](./AGENTS.md) first — it's the source of truth for stack, conv
 
 ```bash
 bun install
-bun run prepare-hooks   # once — installs lefthook pre-commit (Biome + tsc)
-bun run seed            # optional: populate the DB with the curated set (~42 public repos)
+bun run prepare-hooks   # once — installs lefthook pre-commit (Biome + tsc + test)
+bun run seed            # optional: populate the DB with the curated set (124 public repos)
 bun run dev             # http://localhost:3000
+bun run test            # unit tests (node --test + tsx) — requires Node ≥20.9.0
 ```
 
 ## Branch naming
@@ -40,10 +41,11 @@ Don't squash-amend published commits. Don't skip hooks (`--no-verify`); if a hoo
 
 ## Pre-commit hook
 
-`lefthook` runs two jobs on every commit:
+`lefthook` runs three jobs on every commit:
 
 1. **Biome** — `check --write` on staged JS/TS/JSON/CSS. Fixes and re-stages.
 2. **tsc** — `--noEmit` on `*.{ts,tsx}`. Blocks commits that don't typecheck.
+3. **test** — `bun run test` when any `*.{ts,tsx}` file is staged. Runs the full `node --test` suite (~1–2 s); blocks on regressions.
 
 Run `bun run prepare-hooks` once after cloning. CI (`.github/workflows/`) runs the same checks on PR for belt-and-braces.
 
@@ -62,17 +64,15 @@ New PRs auto-populate from [`.github/PULL_REQUEST_TEMPLATE.md`](./.github/PULL_R
 
 ## Motivation
 
-<Why this change. Link to the roadmap item or `tasks/<file>.md`. If it's
-a roadmap item, quote the task's Goal line.>
+<Why this change. Link to the roadmap item or `tasks/<file>.md`. If it's a roadmap item, quote the task's Goal line.>
 
 ## Changes
 
 <Bulleted list of what this PR modifies. Keep it scoped to the summary.>
 
 ## Testing
 
-<How you verified this. Commands run (`bun run score <url>`, `bun x tsc --noEmit`,
-manual pass of specific pages). For UI changes: mobile + desktop, light + dark.>
+<How you verified this. Commands run (`bun run test`, `bun run score <url>`, `bun x tsc --noEmit`, manual pass of specific pages). For UI changes: mobile + desktop, light + dark.>
 
 ## Screenshots / screencasts
 

README.md

@@ -1,13 +1,13 @@
 # Agent Friendly Code
 
-[![Release](https://img.shields.io/badge/release-0.1.0-blue?style=flat-square)](./lib/changelog.ts)
+[![Release](https://img.shields.io/badge/release-0.2.0-blue?style=flat-square)](./lib/changelog.ts)
 [![License: MIT](https://img.shields.io/badge/license-MIT-green?style=flat-square)](./LICENSE)
 [![Next.js 16](https://img.shields.io/badge/Next.js-16-black?style=flat-square)](https://nextjs.org)
 [![Node ≥20.9](https://img.shields.io/badge/node-%E2%89%A520.9-43853d?style=flat-square&logo=node.js&logoColor=white)](https://nodejs.org)
 
 **A public dashboard that ranks open-source repos by how friendly they are for AI coding agents — per model.**
 
-Next.js 16 + SQLite (`better-sqlite3`), styled with Tailwind CSS 4. Spans GitHub, GitLab, and Bitbucket out of the box. Current release: **0.1.0**.
+Next.js 16 + SQLite (`better-sqlite3`), styled with Tailwind CSS 4. Spans GitHub, GitLab, and Bitbucket out of the box. Current release: **0.2.0**.
 
 ![Agent Friendly Code — leaderboard](./public/demo/light.png)
 
@@ -88,8 +88,8 @@ Auth and per-maintainer controls land with the opt-out / claim flow in v0.4.0.
 
 ```bash
 bun install
-bun run prepare-hooks  # once — installs lefthook pre-commit (Biome + tsc)
-bun run seed           # score the curated set (~42 repos) across GH / GL / BB
+bun run prepare-hooks  # once — installs lefthook pre-commit (Biome + tsc + test)
+bun run seed           # score the curated set (124 repos) across GH / GL / BB
 bun run dev            # http://localhost:3000
 ```
 
@@ -104,9 +104,11 @@ bun run score /path/to/local/checkout
 
 Optional: `GITHUB_TOKEN` / `GITLAB_TOKEN` in env to raise API rate limits.
 
+Run the unit tests with `bun run test` (uses `node --test` + `tsx`; requires Node ≥20.9.0).
+
 ## Versioning
 
-`lib/version.ts` and `package.json` carry the current release number (currently **0.1.0**). Bumps happen only when we actually cut a release — never when merging intermediate work. The version pill in the header surfaces the number directly; `/changelog` lists what each release shipped.
+`lib/version.ts` and `package.json` carry the current release number (currently **0.2.0**). Bumps happen only when we actually cut a release — never when merging intermediate work. The version pill in the header surfaces the number directly; `/changelog` lists what each release shipped.
 
 ## Stack & rationale
 
@@ -148,9 +150,10 @@ lib/
   constants/  thresholds, host labels, sort keys
   utils/      format + score-tier helpers
   db.ts       better-sqlite3 schema + queries (all SQL lives here)
-  version.ts  APP_NAME, APP_VERSION, APP_URL, APP_DESCRIPTION, REPO_URL
+  version.ts  APP_NAME, APP_VERSION, IS_PRE_RELEASE, APP_URL, APP_DESCRIPTION, REPO_URL
   changelog.ts / roadmap.ts
 scripts/      CLI entries run via `tsx` (Node) — score, seed, init-db
+tests/        `node --test` unit tests — scorer, signals, URL parser, formatters
 tasks/        Per-version task breakdown (agent-readable)
 public/       Static assets — demo/ screenshots used by the README + OG image
 .claude/      settings.json, hooks/ (Stop guard), skills/
@@ -166,7 +169,6 @@ LICENSE       MIT
 
 See `/roadmap` in the running app or the per-version `tasks/` folders for the full picture.
 
-- **0.2.0 — complete the dogfood**: tests for scorer / signals / URL parser + self-score ≥ 90 on this repo's own rubric.
 - **0.3.0 — real per-model weights**: benchmark harness actually runs agents on scoped tasks per repo; current illustrative weights get replaced with measured ones.
 - **0.4.0 — ecosystem integration**: badge endpoint for READMEs, GitHub Action that comments score delta on PRs, webhook-driven rescoring, OAuth-gated opt-out / claim flow for maintainers.
 - **0.5.0 — alternative recommender**: "repo Y does the same thing and ranks higher for your model."

app/changelog/page.tsx

@@ -18,6 +18,7 @@ export default function ChangelogPage() {
     <>
       <section className="my-3 mb-7">
         <h1 className="mb-2.5 text-[30px] font-bold leading-[1.18] tracking-tight">Changelog</h1>
+
         <p className="m-0 max-w-[70ch] text-[15.5px] text-ink-dim">
           What&apos;s shipped from the{" "}
           <Link href="/roadmap" className="text-ink-dim underline-offset-4 hover:text-ink-soft hover:underline">
@@ -27,26 +28,29 @@ export default function ChangelogPage() {
         </p>
       </section>
 
-      <Panel>
+      <div className="flex flex-col gap-3.5">
         {CHANGELOG.map((entry) => (
-          <div key={entry.label} className="border-b border-line py-6 first:pt-0 last:border-b-0 last:pb-0">
+          <Panel key={entry.label}>
             <div className="mb-2.5 flex flex-wrap items-baseline gap-3.5">
               <span className="inline-block rounded-md border border-line bg-surface-2 px-2.5 py-[3px] font-mono text-[13px] font-semibold text-accent">
                 {entry.label}
               </span>
+
               <span className="mr-auto text-lg font-semibold tracking-tight">{entry.title}</span>
+
               <span className="tabular-nums text-sm text-muted">{entry.date}</span>
             </div>
+
             <ul className="m-0 pl-5 text-[14.5px] text-ink-dim">
               {entry.highlights.map((h) => (
                 <li key={h} className="my-1">
                   {h}
                 </li>
               ))}
             </ul>
-          </div>
+          </Panel>
         ))}
-      </Panel>
+      </div>
     </>
   );
 }

app/layout.tsx

@@ -2,6 +2,7 @@ import type { Metadata, Viewport } from "next";
 import Link from "next/link";
 import "./globals.css";
 
+import { BackToTop } from "@/components/BackToTop";
 import { GoogleAnalytics } from "@/components/GoogleAnalytics";
 import { MobileNav } from "@/components/MobileNav";
 import { VersionPill } from "@/components/VersionPill";
@@ -108,6 +109,8 @@ export default function RootLayout({ children }: { children: React.ReactNode })
             empirically derived.
           </footer>
         </div>
+
+        <BackToTop />
       </body>
     </html>
   );

app/methodology/page.tsx

@@ -35,6 +35,7 @@ export default function MethodologyPage() {
           enough to produce meaningfully different rankings and to show how the UX of per-model scoring feels, but it
           should not be read as a benchmark.
         </p>
+
         <p className="mt-3 text-[14.5px] leading-relaxed text-ink-dim">
           The plan to replace illustrative weights with measured ones is the v0.3.0 milestone on the{" "}
           <Link href="/roadmap" className="text-ink-dim underline-offset-4 hover:text-ink-soft hover:underline">
@@ -56,6 +57,7 @@ export default function MethodologyPage() {
 overall         = mean(per-model scores)
 improvement     = closing a gap unlocks  (1 - pass) × weight / Σweight × 100  points`}
           </pre>
+
           <p className="mt-3 text-sm text-muted">
             <code className="rounded border border-line bg-surface-2 px-1.5 py-0.5 font-mono text-xs">signal.pass</code>{" "}
             is a float in [0, 1] — partial credit is allowed (e.g. a thin README gets 0.3, a long one gets 1.0).
@@ -66,6 +68,7 @@ improvement     = closing a gap unlocks  (1 - pass) × weight / Σweight × 100
       <div className="mt-3.5">
         <Panel>
           <PanelHeading>Signals ({SIGNALS.length})</PanelHeading>
+
           <ul className="m-0 list-none p-0">
             {SIGNALS.map((s) => (
               <li
@@ -91,11 +94,13 @@ improvement     = closing a gap unlocks  (1 - pass) × weight / Σweight × 100
       <div className="mt-3.5">
         <Panel>
           <PanelHeading>Models & weight profiles ({MODELS.length})</PanelHeading>
+
           <ul className="m-0 list-none p-0">
             {MODELS.map((m) => (
               <li key={m.id} className="border-b border-line py-3 last:border-b-0">
                 <div className="text-[15px] font-medium">{m.label}</div>
                 <div className="mt-1 text-[13.5px] text-ink-dim">{m.rationale}</div>
+
                 <details className="mt-2 text-[13px] text-muted">
                   <summary className="cursor-pointer">Weights</summary>
                   <pre className="mt-2 overflow-x-auto rounded-lg border border-line bg-surface-2 px-3 py-2 font-mono text-xs leading-relaxed">
@@ -116,7 +121,9 @@ improvement     = closing a gap unlocks  (1 - pass) × weight / Σweight × 100
           <ul className="m-0 ml-5 list-disc text-[14.5px] leading-relaxed text-ink-dim">
             <li>Whether tests actually pass (we only detect their presence).</li>
             <li>Whether the linter actually runs cleanly.</li>
+
             <li>Whether the dev-env artifact (Makefile, Dockerfile) works end-to-end.</li>
+
             <li>
               Commit-history signals — churn, commit frequency, contributor count. We use
               <code className="mx-1 rounded border border-line bg-surface-2 px-1 py-0.5 font-mono text-xs">
@@ -129,6 +136,7 @@ improvement     = closing a gap unlocks  (1 - pass) × weight / Σweight × 100
               </Link>
               .
             </li>
+
             <li>How agents actually perform on the repo — that&apos;s the v0.3.0 benchmark harness.</li>
           </ul>
         </Panel>