chore: add file-length pre-commit hook; sync docs; normalize Codex naming

Add a file-length lefthook pre-commit that blocks staged .ts/.tsx
over 300 lines under app/, components/, or lib/. scripts/ is exempt
(seed data lists).

Sync AGENTS.md, README.md, and CONTRIBUTING.md with the 4-job hook,
the 155-repo seed count, the new components in the Layout tree, and
the file-length convention.

Normalize 'Codex' -> 'GPT-5 Codex' in AGENTS.md line 3 and the 0.1.0
changelog bullet to match the UI, which has always used the full name.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: hsnice16

AGENTS.md

@@ -1,6 +1,6 @@
 # AGENTS.md
 
-Instructions for AI coding agents (Claude Code, Cursor, Codex, Devin, etc.) working on this repo.
+Instructions for AI coding agents (Claude Code, Cursor, Devin, GPT-5 Codex, etc.) working on this repo.
 
 > `CLAUDE.md` is a one-line pointer to this file. AGENTS.md is the cross-agent standard; keeping one source of truth avoids drift.
 >
@@ -27,9 +27,9 @@ 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 + test on pre-commit)
+bun run prepare-hooks  # once — installs lefthook git hooks (Biome + tsc + test + file-length on pre-commit)
 bun run init-db        # optional — auto-runs on first score
-bun run seed           # score the curated set (124 repos) across GH / GL / BB
+bun run seed           # score the curated set (155 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
@@ -55,6 +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,
+  RepoHero.tsx, SignalListCard.tsx, ModelSuggestions.tsx, PerModelScores.tsx,
   BackToTop.tsx, GoogleAnalytics.tsx
 lib/
   constants/
@@ -75,7 +76,7 @@ lib/
   changelog.ts            # typed ChangelogEntry[]
   roadmap.ts              # typed RoadmapVersion[]
 scripts/
-  init-db.ts, score.ts, seed.ts
+  init-db.ts, score.ts, seed.ts, seed-list.ts
 tests/
   _helpers.ts             # makeFixture / removeFixture build synthetic trees under os.tmpdir()
   format.test.ts          # compactStars, relativeTime, hostLabel
@@ -120,6 +121,7 @@ Keep it that way when adding features. If a component needs data, fetch in the p
 - **Brand on UI**: "Agent Friendly Code" (no hyphen). Repo/package slug + GitHub `User-Agent` string: `agent-friendly-code`.
 - **Version**: `APP_VERSION` in `lib/version.ts` and `package.json`'s `version` carry the current release number. Bump both (and add a new bucket in `lib/changelog.ts`) only when cutting a release — never when merging intermediate work.
 - **Versioning + changelog**: bumps on `lib/version.ts` + `package.json` `version` happen only on a real release, coordinated with a new bucket in `lib/changelog.ts`. The changelog is a **user-facing capability log** — every bullet describes something a dashboard visitor or API caller can see, click, or call. Codebase hygiene (CI, linters, pre-commit, tests), pure internal refactors, dep bumps, and contributor-facing docs (CONTRIBUTING, PR templates) do **not** earn a changelog line — they stay in `tasks/` and the PR description. When a roadmap item ships, remove it from `lib/roadmap.ts` in the same PR — moved, not duplicated.
+- **File length**: `.ts` / `.tsx` under `app/`, `components/`, `lib/` stay ≤ 300 lines — enforced by the `file-length` pre-commit job in `lefthook.yml`. Near the cap, split into subcomponents or extract helpers to `lib/utils/`. `scripts/` is exempt (seed data lists).
 
 ## Adding a signal
 

CONTRIBUTING.md

@@ -8,8 +8,8 @@ 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 + test)
-bun run seed            # optional: populate the DB with the curated set (124 public repos)
+bun run prepare-hooks   # once — installs lefthook pre-commit (Biome + tsc + test + file-length)
+bun run seed            # optional: populate the DB with the curated set (155 public repos)
 bun run dev             # http://localhost:3000
 bun run test            # unit tests (node --test + tsx) — requires Node ≥20.9.0
 ```
@@ -41,11 +41,12 @@ Don't squash-amend published commits. Don't skip hooks (`--no-verify`); if a hoo
 
 ## Pre-commit hook
 
-`lefthook` runs three jobs on every commit:
+`lefthook` runs four 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.
+4. **file-length** — blocks staged `.ts`/`.tsx` under `app/`, `components/`, `lib/` that exceed 300 lines. Split into subcomponents or pull helpers into `lib/utils/`. `scripts/` is exempt.
 
 Run `bun run prepare-hooks` once after cloning. CI (`.github/workflows/`) runs the same checks on PR for belt-and-braces.
 

README.md

@@ -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 + test)
-bun run seed           # score the curated set (124 repos) across GH / GL / BB
+bun run prepare-hooks  # once — installs lefthook pre-commit (Biome + tsc + test + file-length)
+bun run seed           # score the curated set (155 repos) across GH / GL / BB
 bun run dev            # http://localhost:3000
 ```
 

lefthook.yml

@@ -17,3 +17,8 @@ pre-commit:
     - name: test
       glob: "*.{ts,tsx}"
       run: bun run test
+
+    - name: file-length
+      glob: "{app,components,lib}/**/*.{ts,tsx}"
+      run: |
+        wc -l {staged_files} | awk '$2 != "total" && $1 > 300 { printf "✗ %s: %d lines (cap: 300)\n", $2, $1; bad=1 } END { exit bad+0 }'

lib/changelog.ts

@@ -38,7 +38,7 @@ export const CHANGELOG: ChangelogEntry[] = [
     title: "First public release",
     highlights: [
       "Public leaderboard ranking open-source repos by agent-friendliness across GitHub, GitLab, and Bitbucket.",
-      "Per-model scoring — separate ranking for Claude Code, Cursor, Devin, and Codex, each with its own signal weights.",
+      "Per-model scoring — separate ranking for Claude Code, Cursor, Devin, and GPT-5 Codex, each with its own signal weights.",
       "Repo detail page — score breakdown per signal and the top improvements ranked by score-gain for the selected model.",
       "Methodology page explaining what's measured today and what isn't.",
       "Leaderboard controls — live search, host filter (GitHub / GitLab / Bitbucket), rank + stars sort, paginated results.",