feat: version 0.4.0

[hsnice16]

Summary

• Per-model rationales are now docs-cited (no more "illustrative weights" hedge), and four agent-specific instruction-file signals land: .cursor/rules/, GEMINI.md,
  .openhands/setup.sh, .aider.conf.yml.
• Discoverability surface for humans and LLM crawlers: /about, /llms.txt, per-repo Open Graph images, expanded robots/sitemap, and JSON-LD on the leaderboard.
• Roadmap reshuffle — quick wins (history-aware signals, PR score-diff, Claude Code skill) move from 0.4.0 to 0.5.0; downstream buckets renumbered.

Motivation

Ships roadmap milestone 0.4.0 — tasks/0.4.0/{01,02,03}.md. Goals (quoted):

• 01 — "rewrite each agent's rationale in lib/scoring/weights.ts with a docs-cited claim, add a sources field per model, render the URLs in a 'Sources' panel on /methodology, and
  replace the page's 'illustrative' language with 'documented preferences.'"
• 02 — "new signals for each agent's canonical instruction file beyond AGENTS.md: cursor_rules, gemini_md, openhands_setup, aider_conf. Each weighted on the relevant model only."
• 03 — "Lift the dashboard's discoverability for both human visitors and LLM crawlers" via /about, /llms.txt, per-repo OG images, robots + sitemap.

The 0.4.0 bucket was the credibility cut: today's per-model rationales make claims with no source, and ~half were unsupported once verified against each agent's docs. After this release
every claim cites a URL, and each agent gets its own canonical-file signal beyond AGENTS.md.

Changes

• Sourced rationales — lib/scoring/weights.ts adds a sources: string[] per model, rationales rewritten with docs-cited claims. /methodology renders a Sources panel under each
  model and drops the "illustrative" framing. Reweights: Devin CI 1.0 → 0.7, Codex agents_md 0.7 → 0.9, Cursor agents_md 0.6 → 0.8, new cursor_rules weight on Cursor.
• Agent-specific signals — lib/scoring/signals/{cursor-rules,gemini-md,aider-conf,openhands-setup}.ts + tests. Each is per-agent (other models default to 0 — deliberate, not
  absent). Wired into lib/scoring/signals/index.ts; tests/scorer.test.ts updated.
• Discoverability — app/about/page.tsx, app/llms.txt/route.ts, app/repo/[id]/opengraph-image.tsx, app/package/page.tsx. app/robots.ts lists GPTBot/ClaudeBot/PerplexityBot
  allows and blocks /api/. app/sitemap.ts includes /about + /llms.txt. app/layout.tsx + app/page.tsx add ItemList + SoftwareSourceCode JSON-LD; /repo/[id] page metadata
  expanded.
• Roadmap sync — lib/version.ts, lib/roadmap.ts, lib/changelog.ts updated for 0.4.0. tasks/0.4.0/ marked done with READMEs; tasks/0.5.0/–tasks/0.7.0/ renumbered
  (history-aware signals + PR score-diff + Claude Code skill → 0.5.0; webhook + alternatives v2 → 0.6.0; OAuth opt-out + package overlay at scale → 0.7.0).
• Seed + scoring data — scripts/seed.ts + new scripts/seed-packages.ts; data/rank.db re-scored on the new rubric (161 repos).
• Docs — AGENTS.md + README.md updated for the new signals and surfaces.

Testing

• bun test — all suites pass, including new tests/signals/{cursor-rules,gemini-md,aider-conf,openhands-setup}.test.ts and updated tests/scorer.test.ts.
• bun x tsc --noEmit — clean.
• Manual pass: /, /methodology (Sources panel renders per model), /about, /package, /repo/[id], /llms.txt, /sitemap.xml, /robots.txt, /repo/[id]/opengraph-image —
  checked mobile + desktop, light + dark.

Docs + roadmap sync

• Ships a roadmap item — 0.4.0's three tasks removed from lib/roadmap.ts, added to lib/changelog.ts under the 0.4.0 bucket. tasks/0.4.0/ marked done; downstream tasks renumbered
  into tasks/0.5.0/–tasks/0.7.0/.
• AGENTS.md / README.md updated for the new agent-specific signals and discoverability surfaces.

Risks / rollback

• Score shifts: reweights (Devin CI, Codex/Cursor agents_md) plus four new signals re-rank the leaderboard. Repos missing the new agent-specific files will drop on the affected
  model. Mitigated by per-agent scoping — a repo missing GEMINI.md only loses points on the Gemini ranking, not overall.
• OG image route: /repo/[id]/opengraph-image runs at the edge via next/og; if it errors at runtime, share-card previews fall back to the default /og.png (no page-level
  breakage).
• Rollback: revert the single feat: version 0.4.0 commit on main. DB rebuild via bun run seed && bun run score if the rubric needs reverting.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
agent-friendly-code	Ready	Preview, Comment	Apr 26, 2026 7:05pm