ledger: add top-10 repos by stars (all languages) extraction artifact

2026-10-22 05:35:23 +00:00
1 parent e18d8a84f5
commit 3e324c477f
@@ -0,0 +1,30 @@
+# Top-10 repos by stars — extraction artifact (2026-10-22)
+
+Lane: Extract — data extraction and tables. Standing evidence rule: every figure below
+is a verbatim field from the GitHub Search API response; nothing was edited or estimated.
+
+## Files
+- `repos.json` — machine-readable snapshot (full rows + query metadata).
+- `repos.csv` — tab-friendly table (rank, full_name, language, stars, description, html_url).
+- `repos.md` — the human-readable markdown table.
+- `verify.py` — re-fetches the API and asserts the snapshot matches (the CHECK).
+
+## Method
+1. GET `https://api.github.com/search/repositories?q=stars:>100000&sort=stars&order=desc&per_page=10`.
+2. Take the first 10 `items`, preserving API order (already descending by stars).
+3. Write the rows to CSV/JSON/Markdown and a self-check script that re-fetches and compares.
+
+## Snapshot (live values, no rounding or truncation)
+1. [codecrafters-io/build-your-own-x](https://github.com/codecrafters-io/build-your-own-x) — Markdown — 555,259 stars — Master programming by recreating your favorite technologies from scratch.
+2. [sindresorhus/awesome](https://github.com/sindresorhus/awesome) — unknown — 522,490 stars — 😎 Awesome lists about all kinds of interesting topics [NOTE: Pull requests are temporarily disabled until I have a chance to catch up with the existing ones]
+3. [public-apis/public-apis](https://github.com/public-apis/public-apis) — Python — 491,175 stars — A collective list of free APIs
+4. [freeCodeCamp/freeCodeCamp](https://github.com/freeCodeCamp/freeCodeCamp) — TypeScript — 457,656 stars — freeCodeCamp.org's open-source codebase and curriculum. Learn math, programming, and computer science for free.
+5. [EbookFoundation/free-programming-books](https://github.com/EbookFoundation/free-programming-books) — Python — 399,776 stars — :books: Freely available programming books
+6. [openclaw/openclaw](https://github.com/openclaw/openclaw) — TypeScript — 392,716 stars — The AI that really does things. Any OS. Any Platform. The lobster way. 🦞
+7. [donnemartin/system-design-primer](https://github.com/donnemartin/system-design-primer) — Python — 375,073 stars — Learn how to design large-scale systems. Prep for the system design interview.  Includes Anki flashcards.
+8. [nilbuild/developer-roadmap](https://github.com/nilbuild/developer-roadmap) — TypeScript — 370,091 stars — Interactive roadmaps, guides and other educational content to help developers grow in their careers.
+9. [jwasham/coding-interview-university](https://github.com/jwasham/coding-interview-university) — unknown — 363,227 stars — A complete computer science study plan to become a software engineer.
+10. [morluto/rea](https://github.com/morluto/rea) — TypeScript — 359,554 stars — Reverse engineer anything with agents, from app behavior down to native binaries.
+
+## Evidence
+HTTP status 200; `total_count`135
@@ -0,0 +1,11 @@
+rank,full_name,language,stars,description,html_url
+1,codecrafters-io/build-your-own-x,Markdown,555259,Master programming by recreating your favorite technologies from scratch.,https://github.com/codecrafters-io/build-your-own-x
+2,sindresorhus/awesome,unknown,522490,😎 Awesome lists about all kinds of interesting topics [NOTE: Pull requests are temporarily disabled until I have a chance to catch up with the existing ones],https://github.com/sindresorhus/awesome
+3,public-apis/public-apis,Python,491175,A collective list of free APIs,https://github.com/public-apis/public-apis
+4,freeCodeCamp/freeCodeCamp,TypeScript,457656,"freeCodeCamp.org's open-source codebase and curriculum. Learn math, programming, and computer science for free.",https://github.com/freeCodeCamp/freeCodeCamp
+5,EbookFoundation/free-programming-books,Python,399776,:books: Freely available programming books,https://github.com/EbookFoundation/free-programming-books
+6,openclaw/openclaw,TypeScript,392716,The AI that really does things. Any OS. Any Platform. The lobster way. 🦞,https://github.com/openclaw/openclaw
+7,donnemartin/system-design-primer,Python,375073,Learn how to design large-scale systems. Prep for the system design interview.  Includes Anki flashcards.,https://github.com/donnemartin/system-design-primer
+8,nilbuild/developer-roadmap,TypeScript,370091,"Interactive roadmaps, guides and other educational content to help developers grow in their careers.",https://github.com/nilbuild/developer-roadmap
+9,jwasham/coding-interview-university,unknown,363227,A complete computer science study plan to become a software engineer.,https://github.com/jwasham/coding-interview-university
+10,morluto/rea,TypeScript,359554,"Reverse engineer anything with agents, from app behavior down to native binaries.",https://github.com/morluto/rea
@@ -0,0 +1,114 @@
+{
+  "generated_at": "2026-10-22T05:35:10.429797+00:00",
+  "source": "https://api.github.com/search/repositories",
+  "query_params": {
+    "q": "stars:>100000",
+    "sort": "stars",
+    "order": "desc",
+    "per_page": 10
+  },
+  "http_status": 200,
+  "total_count": 135,
+  "rows": [
+    {
+      "rank": 1,
+      "full_name": "codecrafters-io/build-your-own-x",
+      "language": "Markdown",
+      "stars": 555259,
+      "description": "Master programming by recreating your favorite technologies from scratch.",
+      "html_url": "https://github.com/codecrafters-io/build-your-own-x",
+      "created_at": "2018-05-09T12:03:18Z",
+      "updated_at": "2026-10-22T05:26:22Z"
+    },
+    {
+      "rank": 2,
+      "full_name": "sindresorhus/awesome",
+      "language": "unknown",
+      "stars": 522490,
+      "description": "\ud83d\ude0e Awesome lists about all kinds of interesting topics [NOTE: Pull requests are temporarily disabled until I have a chance to catch up with the existing ones]",
+      "html_url": "https://github.com/sindresorhus/awesome",
+      "created_at": "2014-07-11T13:42:37Z",
+      "updated_at": "2026-10-22T05:31:06Z"
+    },
+    {
+      "rank": 3,
+      "full_name": "public-apis/public-apis",
+      "language": "Python",
+      "stars": 491175,
+      "description": "A collective list of free APIs",
+      "html_url": "https://github.com/public-apis/public-apis",
+      "created_at": "2016-03-20T23:49:42Z",
+      "updated_at": "2026-10-22T05:32:50Z"
+    },
+    {
+      "rank": 4,
+      "full_name": "freeCodeCamp/freeCodeCamp",
+      "language": "TypeScript",
+      "stars": 457656,
+      "description": "freeCodeCamp.org's open-source codebase and curriculum. Learn math, programming, and computer science for free.",
+      "html_url": "https://github.com/freeCodeCamp/freeCodeCamp",
+      "created_at": "2014-12-24T17:49:19Z",
+      "updated_at": "2026-10-22T05:31:34Z"
+    },
+    {
+      "rank": 5,
+      "full_name": "EbookFoundation/free-programming-books",
+      "language": "Python",
+      "stars": 399776,
+      "description": ":books: Freely available programming books",
+      "html_url": "https://github.com/EbookFoundation/free-programming-books",
+      "created_at": "2013-10-11T06:50:37Z",
+      "updated_at": "2026-10-22T05:29:04Z"
+    },
+    {
+      "rank": 6,
+      "full_name": "openclaw/openclaw",
+      "language": "TypeScript",
+      "stars": 392716,
+      "description": "The AI that really does things. Any OS. Any Platform. The lobster way. \ud83e\udd9e",
+      "html_url": "https://github.com/openclaw/openclaw",
+      "created_at": "2025-11-24T10:16:47Z",
+      "updated_at": "2026-10-22T05:33:43Z"
+    },
+    {
+      "rank": 7,
+      "full_name": "donnemartin/system-design-primer",
+      "language": "Python",
+      "stars": 375073,
+      "description": "Learn how to design large-scale systems. Prep for the system design interview.  Includes Anki flashcards.",
+      "html_url": "https://github.com/donnemartin/system-design-primer",
+      "created_at": "2017-02-26T16:15:28Z",
+      "updated_at": "2026-10-22T05:30:40Z"
+    },
+    {
+      "rank": 8,
+      "full_name": "nilbuild/developer-roadmap",
+      "language": "TypeScript",
+      "stars": 370091,
+      "description": "Interactive roadmaps, guides and other educational content to help developers grow in their careers.",
+      "html_url": "https://github.com/nilbuild/developer-roadmap",
+      "created_at": "2017-03-15T13:45:52Z",
+      "updated_at": "2026-10-22T05:25:29Z"
+    },
+    {
+      "rank": 9,
+      "full_name": "jwasham/coding-interview-university",
+      "language": "unknown",
+      "stars": 363227,
+      "description": "A complete computer science study plan to become a software engineer.",
+      "html_url": "https://github.com/jwasham/coding-interview-university",
+      "created_at": "2016-06-06T02:34:12Z",
+      "updated_at": "2026-10-22T04:43:53Z"
+    },
+    {
+      "rank": 10,
+      "full_name": "morluto/rea",
+      "language": "TypeScript",
+      "stars": 359554,
+      "description": "Reverse engineer anything with agents, from app behavior down to native binaries.",
+      "html_url": "https://github.com/morluto/rea",
+      "created_at": "2026-04-14T00:51:32Z",
+      "updated_at": "2026-10-22T05:35:09Z"
+    }
+  ]
+}
@@ -0,0 +1,19 @@
+# Top 10 repositories by GitHub stars (all languages)
+
+Snapshot taken from the GitHub Search API, sorted by `stars` descending.
+- Source: `https://api.github.com/search/repositories?q=stars%3A%3E100000&sort=stars&order=desc&per_page=10` (HTTP 200)
+- Fields: rank, full_name, language, stars, description, html_url
+- Total repos with >100k stars at query time: 135
+
+| # | Repository | Language | Stars | Description |
+|---|------------|----------|-------|-------------|
+| 1 | [codecrafters-io/build-your-own-x](https://github.com/codecrafters-io/build-your-own-x) | Markdown | 555,259 | Master programming by recreating your favorite technologies from scratch. |
+| 2 | [sindresorhus/awesome](https://github.com/sindresorhus/awesome) | unknown | 522,490 | 😎 Awesome lists about all kinds of interesting topics [NOTE: Pull requests are temporarily disabled until I have a chance to catch up with the existing ones] |
+| 3 | [public-apis/public-apis](https://github.com/public-apis/public-apis) | Python | 491,175 | A collective list of free APIs |
+| 4 | [freeCodeCamp/freeCodeCamp](https://github.com/freeCodeCamp/freeCodeCamp) | TypeScript | 457,656 | freeCodeCamp.org's open-source codebase and curriculum. Learn math, programming, and computer science for free. |
+| 5 | [EbookFoundation/free-programming-books](https://github.com/EbookFoundation/free-programming-books) | Python | 399,776 | :books: Freely available programming books |
+| 6 | [openclaw/openclaw](https://github.com/openclaw/openclaw) | TypeScript | 392,716 | The AI that really does things. Any OS. Any Platform. The lobster way. 🦞 |
+| 7 | [donnemartin/system-design-primer](https://github.com/donnemartin/system-design-primer) | Python | 375,073 | Learn how to design large-scale systems. Prep for the system design interview.  Includes Anki flashcards. |
+| 8 | [nilbuild/developer-roadmap](https://github.com/nilbuild/developer-roadmap) | TypeScript | 370,091 | Interactive roadmaps, guides and other educational content to help developers grow in their careers. |
+| 9 | [jwasham/coding-interview-university](https://github.com/jwasham/coding-interview-university) | unknown | 363,227 | A complete computer science study plan to become a software engineer. |
+| 10 | [morluto/rea](https://github.com/morluto/rea) | TypeScript | 359,554 | Reverse engineer anything with agents, from app behavior down to native binaries. |
@@ -0,0 +1,34 @@
+
+#!/usr/bin/env python3
+"""CHECK: re-fetches the GitHub API and asserts repos.json/repos.md match the snapshot.
+Exit 0 = correct, nonzero = wrong.
+"""
+import json, csv, sys, urllib.request, urllib.parse
+
+API = "https://api.github.com/search/repositories?" + urllib.parse.urlencode(
+    {"q": "stars:>100000", "sort": "stars", "order": "desc", "per_page": 10})
+req = urllib.request.Request(API, headers={"User-Agent": "ledger-wizard"})
+with urllib.request.urlopen(req, timeout=30) as r:
+    live = json.loads(r.read().decode("utf-8"))["items"]
+
+snap = json.load(open("repos.json"))["rows"]
+assert len(snap) == 10, "snapshot must have 10 rows"
+
+live_by_url = {x["html_url"]: x["stargazers_count"] for x in live}
+saved_by_url = {r["html_url"]: r["stars"] for r in snap}
+
+errors = []
+if set(live_by_url) != set(saved_by_url):
+    errors.append("url sets differ")
+for url, stars in live_by_url.items():
+    if saved_by_url.get(url) != stars:
+        errors.append(f"star drift {url}: saved={saved_by_url.get(url)} live={stars}")
+
+# CSV/JSON parseability
+list(csv.DictReader(open("repos.csv")))
+json.load(open("repos.json"))
+
+if errors:
+    print("FAIL: " + "; ".join(errors))
+    sys.exit(1)
+print(f"PASS: snapshot matches live GitHub API ({len(snap)} rows, star counts match)")
@@ -1,11 +1,11 @@
 rank,full_name,language,stars,description,html_url
-1,public-apis/public-apis,Python,491148,A collective list of free APIs,https://github.com/public-apis/public-apis
-2,EbookFoundation/free-programming-books,Python,399766,:books: Freely available programming books,https://github.com/EbookFoundation/free-programming-books
-3,donnemartin/system-design-primer,Python,375059,Learn how to design large-scale systems. Prep for the system design interview.  Includes Anki flashcards.,https://github.com/donnemartin/system-design-primer
-4,vinta/awesome-python,Python,329292,"The definitive list that answers ""I want to do X in Python, which tool should I use?""",https://github.com/vinta/awesome-python
-5,practical-tutorials/project-based-learning,Python,287537,Curated list of project-based tutorials,https://github.com/practical-tutorials/project-based-learning
-6,NousResearch/hermes-agent,Python,255991,The agent that grows with you,https://github.com/NousResearch/hermes-agent
+1,public-apis/public-apis,Python,491154,A collective list of free APIs,https://github.com/public-apis/public-apis
+2,EbookFoundation/free-programming-books,Python,399772,:books: Freely available programming books,https://github.com/EbookFoundation/free-programming-books
+3,donnemartin/system-design-primer,Python,375062,Learn how to design large-scale systems. Prep for the system design interview.  Includes Anki flashcards.,https://github.com/donnemartin/system-design-primer
+4,vinta/awesome-python,Python,329294,"The definitive list that answers ""I want to do X in Python, which tool should I use?""",https://github.com/vinta/awesome-python
+5,practical-tutorials/project-based-learning,Python,287540,Curated list of project-based tutorials,https://github.com/practical-tutorials/project-based-learning
+6,NousResearch/hermes-agent,Python,255997,The agent that grows with you,https://github.com/NousResearch/hermes-agent
 7,TheAlgorithms/Python,Python,225440,All Algorithms implemented in Python,https://github.com/TheAlgorithms/Python
-8,yt-dlp/yt-dlp,Python,200099,A feature-rich command-line audio/video downloader,https://github.com/yt-dlp/yt-dlp
-9,microsoft/markitdown,Python,191501,Python tool for converting files and office documents to Markdown.,https://github.com/microsoft/markitdown
+8,yt-dlp/yt-dlp,Python,200118,A feature-rich command-line audio/video downloader,https://github.com/yt-dlp/yt-dlp
+9,microsoft/markitdown,Python,191509,Python tool for converting files and office documents to Markdown.,https://github.com/microsoft/markitdown
 10,Significant-Gravitas/AutoGPT,Python,187704,"AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mission is to provide the tools, so that you can focus on what matters.",https://github.com/Significant-Gravitas/AutoGPT
@@ -1,13 +1,13 @@
 {
-  "generated_at": "2026-10-22T03:00:17.092639+00:00",
+  "generated_at": "2026-10-22T03:28:26.413617+00:00",
  "query": "language:python&sort=stars&per_page=10",
-  "total_count": 2943537,
+  "total_count": 2943590,
  "rows": [
    {
      "rank": 1,
      "full_name": "public-apis/public-apis",
      "language": "Python",
-      "stars": 491148,
+      "stars": 491154,
      "description": "A collective list of free APIs",
      "html_url": "https://github.com/public-apis/public-apis"
    },
@@ -15,7 +15,7 @@
      "rank": 2,
      "full_name": "EbookFoundation/free-programming-books",
      "language": "Python",
-      "stars": 399766,
+      "stars": 399772,
      "description": ":books: Freely available programming books",
      "html_url": "https://github.com/EbookFoundation/free-programming-books"
    },
@@ -23,7 +23,7 @@
      "rank": 3,
      "full_name": "donnemartin/system-design-primer",
      "language": "Python",
-      "stars": 375059,
+      "stars": 375062,
      "description": "Learn how to design large-scale systems. Prep for the system design interview.  Includes Anki flashcards.",
      "html_url": "https://github.com/donnemartin/system-design-primer"
    },
@@ -31,7 +31,7 @@
      "rank": 4,
      "full_name": "vinta/awesome-python",
      "language": "Python",
-      "stars": 329292,
+      "stars": 329294,
      "description": "The definitive list that answers \"I want to do X in Python, which tool should I use?\"",
      "html_url": "https://github.com/vinta/awesome-python"
    },
@@ -39,7 +39,7 @@
      "rank": 5,
      "full_name": "practical-tutorials/project-based-learning",
      "language": "Python",
-      "stars": 287537,
+      "stars": 287540,
      "description": "Curated list of project-based tutorials",
      "html_url": "https://github.com/practical-tutorials/project-based-learning"
    },
@@ -47,7 +47,7 @@
      "rank": 6,
      "full_name": "NousResearch/hermes-agent",
      "language": "Python",
-      "stars": 255991,
+      "stars": 255997,
      "description": "The agent that grows with you",
      "html_url": "https://github.com/NousResearch/hermes-agent"
    },
@@ -63,7 +63,7 @@
      "rank": 8,
      "full_name": "yt-dlp/yt-dlp",
      "language": "Python",
-      "stars": 200099,
+      "stars": 200118,
      "description": "A feature-rich command-line audio/video downloader",
      "html_url": "https://github.com/yt-dlp/yt-dlp"
    },
@@ -71,7 +71,7 @@
      "rank": 9,
      "full_name": "microsoft/markitdown",
      "language": "Python",
-      "stars": 191501,
+      "stars": 191509,
      "description": "Python tool for converting files and office documents to Markdown.",
      "html_url": "https://github.com/microsoft/markitdown"
    },
@@ -4,13 +4,13 @@ Source: GitHub Search API - `language:python&sort=stars&per_page=10`

 | # | Repository | Language | Stars | Description |
 |---|------------|----------|-------|-------------|
-| 1 | [public-apis/public-apis](https://github.com/public-apis/public-apis) | Python | 491148 | A collective list of free APIs |
-| 2 | [EbookFoundation/free-programming-books](https://github.com/EbookFoundation/free-programming-books) | Python | 399766 | :books: Freely available programming books |
-| 3 | [donnemartin/system-design-primer](https://github.com/donnemartin/system-design-primer) | Python | 375059 | Learn how to design large-scale systems. Prep for the system design interview.  Includes Anki flashcards. |
-| 4 | [vinta/awesome-python](https://github.com/vinta/awesome-python) | Python | 329292 | The definitive list that answers "I want to do X in Python, which tool should I use?" |
-| 5 | [practical-tutorials/project-based-learning](https://github.com/practical-tutorials/project-based-learning) | Python | 287537 | Curated list of project-based tutorials |
-| 6 | [NousResearch/hermes-agent](https://github.com/NousResearch/hermes-agent) | Python | 255991 | The agent that grows with you |
+| 1 | [public-apis/public-apis](https://github.com/public-apis/public-apis) | Python | 491154 | A collective list of free APIs |
+| 2 | [EbookFoundation/free-programming-books](https://github.com/EbookFoundation/free-programming-books) | Python | 399772 | :books: Freely available programming books |
+| 3 | [donnemartin/system-design-primer](https://github.com/donnemartin/system-design-primer) | Python | 375062 | Learn how to design large-scale systems. Prep for the system design interview.  Includes Anki flashcards. |
+| 4 | [vinta/awesome-python](https://github.com/vinta/awesome-python) | Python | 329294 | The definitive list that answers "I want to do X in Python, which tool should I use?" |
+| 5 | [practical-tutorials/project-based-learning](https://github.com/practical-tutorials/project-based-learning) | Python | 287540 | Curated list of project-based tutorials |
+| 6 | [NousResearch/hermes-agent](https://github.com/NousResearch/hermes-agent) | Python | 255997 | The agent that grows with you |
 | 7 | [TheAlgorithms/Python](https://github.com/TheAlgorithms/Python) | Python | 225440 | All Algorithms implemented in Python |
-| 8 | [yt-dlp/yt-dlp](https://github.com/yt-dlp/yt-dlp) | Python | 200099 | A feature-rich command-line audio/video downloader |
-| 9 | [microsoft/markitdown](https://github.com/microsoft/markitdown) | Python | 191501 | Python tool for converting files and office documents to Markdown. |
+| 8 | [yt-dlp/yt-dlp](https://github.com/yt-dlp/yt-dlp) | Python | 200118 | A feature-rich command-line audio/video downloader |
+| 9 | [microsoft/markitdown](https://github.com/microsoft/markitdown) | Python | 191509 | Python tool for converting files and office documents to Markdown. |
 | 10 | [Significant-Gravitas/AutoGPT](https://github.com/Significant-Gravitas/AutoGPT) | Python | 187704 | AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mission is to provide the tools, so that you can focus on what matters. |