From 9b556ffe6c0c0528697e15f7f4f35107de212ce1 Mon Sep 17 00:00:00 2001
From: Joe Mou <dev@mou.fo>
Date: Wed, 15 Jul 2026 02:08:17 -0400
Subject: Add Cloudflare Workers deployment target

Split routes into a shared createApp() (src/app.ts) used by both the
Node entry (src/index.ts) and a new Workers entry (src/worker.ts).
Workers disallow runtime code generation, so scripts/compile-views.ts
precompiles the Eta templates into src/views.generated.ts and rendering
switches from renderAsync to the sync render. Static files move to
public/static so Workers Static Assets can serve them; the Node build
and serveStatic root are updated to match.

Deploy with pnpm run deploy:cf, local dev with pnpm run dev:cf.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 cgithub/src/app.ts | 132 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 132 insertions(+)
 create mode 100644 cgithub/src/app.ts

(limited to 'cgithub/src/app.ts')

diff --git a/cgithub/src/app.ts b/cgithub/src/app.ts
new file mode 100644
index 0000000..78b59ae
--- /dev/null
+++ b/cgithub/src/app.ts
@@ -0,0 +1,132 @@
+import type { Eta } from "eta";
+import { type Context, Hono } from "hono";
+import type { StatusCode } from "hono/utils/http-status";
+import {
+  getGitHubBlob,
+  getGitHubCommits,
+  getGitHubIssues,
+  getGitHubOwner,
+  getGitHubPulls,
+  getGitHubRelease,
+  getGitHubReleases,
+  getGitHubRepo,
+  getGitHubTree,
+  GitHubHTTPError,
+  RedirectError,
+} from "./scraper.ts";
+
+export function createApp(eta: Eta) {
+  const app = new Hono();
+
+  app.get("/", async (c) => {
+    return c.html(eta.render("home.eta", {}));
+  });
+
+  async function tryRender<T extends object>(c: Context, template: string, promise: Promise<T>) {
+    let data: T;
+    try {
+      data = await promise;
+    } catch (e) {
+      if (e instanceof RedirectError) {
+        if (e.location.startsWith("https://")) {
+          c.header("Referrer-Policy", "no-referrer");
+        }
+        return c.redirect(e.location);
+      } else if (e instanceof GitHubHTTPError) {
+        c.status(e.status as StatusCode);
+        const message = `GitHub responded with HTTP ${e.status} ${e.message}`;
+        return c.html(eta.render("error.eta", { title: e.message, message }));
+      } else {
+        c.status(500);
+        return c.html(eta.render("error.eta", { message: "" + e }));
+      }
+    }
+    return c.html(eta.render(template, data));
+  }
+
+  app.get("/:owner", async (c) => {
+    const { owner } = c.req.param();
+    return tryRender(c, "owner.eta", getGitHubOwner(owner));
+  });
+
+  app.get("/:owner/:repo", async (c) => {
+    const { owner, repo } = c.req.param();
+    return tryRender(c, "repo.eta", getGitHubRepo(owner, repo));
+  });
+
+  app.get("/:owner/:repo/tree/:branch/:path{.*}?", async (c) => {
+    const { owner, repo, branch, path = "" } = c.req.param();
+    return tryRender(c, "tree.eta", getGitHubTree(owner, repo, branch, path));
+  });
+
+  app.get("/:owner/:repo/blob/:branch/:path{.*}", async (c) => {
+    const { owner, repo, branch, path } = c.req.param();
+    return tryRender(c, "blob.eta", getGitHubBlob(owner, repo, branch, path));
+  });
+
+  app.get("/:owner/:repo/raw/:branch/:path{.*}", async (c) => {
+    const { owner, repo, branch, path } = c.req.param();
+    c.header("Referrer-Policy", "no-referrer");
+    return c.redirect(`https://raw.githubusercontent.com/${owner}/${repo}/${branch}/${path}`);
+  });
+
+  app.get("/:owner/:repo/issues", async (c) => {
+    const { owner, repo } = c.req.param();
+    const q = c.req.query("q");
+
+    // GitHub supports combined issue/PR search, apparently for legacy. We just
+    // redirect to issue-only search.
+    if (q && !/\bis:issue\b/.test(q)) {
+      return c.redirect(`/${owner}/${repo}/issues?q=${encodeURIComponent(`is:issue ${q}`)}`);
+    }
+
+    return tryRender(c, "issues.eta", getGitHubIssues(owner, repo, { q }));
+  });
+
+  app.get("/:owner/:repo/pulls", async (c) => {
+    const { owner, repo } = c.req.param();
+    const q = c.req.query("q");
+    return tryRender(c, "pulls.eta", getGitHubPulls(owner, repo, { q }));
+  });
+
+  app.get("/:owner/:repo/search", async (c) => {
+    const { owner, repo } = c.req.param();
+    const q = c.req.query("q") ?? "";
+    const type = c.req.query("type") ?? "issues";
+
+    if (type === "issues") {
+      return c.redirect(`/${owner}/${repo}/issues?q=${encodeURIComponent(q)}`);
+    } else if (type === "pullrequests") {
+      return c.redirect(`/${owner}/${repo}/pulls?q=${encodeURIComponent(q)}`);
+    }
+
+    // Redirect unhandled search types (like code, which requires sign in anyway).
+    c.header("Referrer-Policy", "no-referrer");
+    return c.redirect(
+      `https://github.com/${owner}/${repo}/search?${new URLSearchParams(c.req.query()).toString()}`,
+    );
+  });
+
+  app.get("/:owner/:repo/commits/:branch/:path{.*}?", async (c) => {
+    const { owner, repo, branch, path = "" } = c.req.param();
+    return tryRender(c, "commits.eta", getGitHubCommits(owner, repo, branch, path));
+  });
+
+  app.get("/:owner/:repo/releases/tag/:tag", async (c) => {
+    const { owner, repo, tag } = c.req.param();
+    return tryRender(c, "release.eta", getGitHubRelease(owner, repo, tag));
+  });
+
+  app.get("/:owner/:repo/releases", async (c) => {
+    const { owner, repo } = c.req.param();
+    return tryRender(c, "releases.eta", getGitHubReleases(owner, repo));
+  });
+
+  app.all("*", async (c) => {
+    const path = c.req.path;
+    c.header("Referrer-Policy", "no-referrer");
+    return c.redirect(`https://github.com${path}`);
+  });
+
+  return app;
+}
-- 
cgit v1.3.1


From 6240cf1c6b73b7ed34ff5816b53333382c229f5c Mon Sep 17 00:00:00 2001
From: Joe Mou <dev@mou.fo>
Date: Tue, 21 Jul 2026 17:46:58 -0400
Subject: Add async branch/tag dropdown and latest-commit bar

Adds two lazily-fetched UI pieces to match vanilla GitHub while keeping
initial page loads plain server-rendered HTML: a branch/tag selector
(native <dialog>, CSS anchor-positioned to its button, light-dismissed
via closedby="any") and a latest-commit bar above the file listing.
Both are populated by new /api/:owner/:repo/refs/:type and
/api/:owner/:repo/latest-commit/:branch/:path routes; the latter calls
GitHub's own /latest-commit JSON endpoint (the same one the React UI
uses) rather than scraping the full commit history page.
---
 cgithub/public/static/refs.js   |  60 ++++++++++++++
 cgithub/public/static/style.css |  62 ++++++++++++++
 cgithub/src/app.ts              |  46 +++++++++++
 cgithub/src/scraper.test.ts     |  41 ++++++++++
 cgithub/src/scraper.ts          | 177 ++++++++++++++++++++++++++++++++++++++--
 cgithub/views/_latestCommit.eta |  16 ++++
 cgithub/views/_nav.eta          |  11 ++-
 cgithub/views/_refs.eta         |  17 ++++
 cgithub/views/_tree.eta         |   3 +
 cgithub/views/layout.eta        |   1 +
 10 files changed, 426 insertions(+), 8 deletions(-)
 create mode 100644 cgithub/public/static/refs.js
 create mode 100644 cgithub/views/_latestCommit.eta
 create mode 100644 cgithub/views/_refs.eta

(limited to 'cgithub/src/app.ts')

diff --git a/cgithub/public/static/refs.js b/cgithub/public/static/refs.js
new file mode 100644
index 0000000..28b8373
--- /dev/null
+++ b/cgithub/public/static/refs.js
@@ -0,0 +1,60 @@
+// Progressive enhancement for two bits of data GitHub itself loads lazily:
+// the branch/tag dropdown and the latest-commit bar above a file listing.
+// Both degrade gracefully without JS: the button's command/commandfor still
+// opens the (empty) dialog natively; the commit placeholder just never fills
+// in.
+document.addEventListener("DOMContentLoaded", () => {
+  const dialog = document.querySelector(".ref-selector-menu");
+  if (dialog) {
+    const list = dialog.querySelector(".ref-selector-list");
+    const { owner, repo } = dialog.dataset;
+    const cache = {};
+
+    async function load(type) {
+      if (Object.prototype.hasOwnProperty.call(cache, type)) {
+        list.innerHTML = cache[type];
+        return;
+      }
+      list.textContent = "Loading…";
+      try {
+        const res = await fetch(`/api/${owner}/${repo}/refs/${type}`);
+        const html = res.ok ? await res.text() : "";
+        cache[type] = html || "Failed to load.";
+        list.innerHTML = cache[type];
+      } catch {
+        list.textContent = "Failed to load.";
+      }
+    }
+
+    let opened = false;
+    dialog.addEventListener("toggle", () => {
+      if (dialog.open && !opened) {
+        opened = true;
+        load("branches");
+      }
+    });
+
+    for (const tab of dialog.querySelectorAll("[data-ref-type]")) {
+      tab.addEventListener("click", () => {
+        for (const other of dialog.querySelectorAll("[data-ref-type]")) {
+          other.classList.toggle("active", other === tab);
+        }
+        load(tab.dataset.refType);
+      });
+    }
+  }
+
+  const commitPlaceholder = document.querySelector(".latest-commit-placeholder");
+  if (commitPlaceholder) {
+    fetch(commitPlaceholder.dataset.src)
+      .then((res) => (res.ok ? res.text() : ""))
+      .then((html) => {
+        if (html.trim()) {
+          commitPlaceholder.outerHTML = html;
+        } else {
+          commitPlaceholder.remove();
+        }
+      })
+      .catch(() => commitPlaceholder.remove());
+  }
+});
diff --git a/cgithub/public/static/style.css b/cgithub/public/static/style.css
index e698993..983cb86 100644
--- a/cgithub/public/static/style.css
+++ b/cgithub/public/static/style.css
@@ -160,6 +160,68 @@ body > footer {
   border: 1px solid var(--border-color);
 }
 
+.ref-selector-button {
+  anchor-name: --ref-selector-anchor;
+}
+
+.ref-selector-menu {
+  position: absolute;
+  position-anchor: --ref-selector-anchor;
+  position-area: bottom span-right;
+  width: 16rem;
+  max-height: 20rem;
+  overflow-y: auto;
+  overflow-wrap: break-word;
+  background: var(--body-background);
+  border: 1px solid var(--border-color);
+  padding: 0.5rem;
+
+  &::backdrop {
+    background: transparent;
+  }
+}
+
+.ref-selector-tabs {
+  display: flex;
+  margin-bottom: 0.5rem;
+
+  button {
+    flex: 1;
+    padding: 0.25rem;
+    cursor: pointer;
+    &.active {
+      font-weight: bold;
+      border-bottom: 2px solid var(--link-color);
+    }
+  }
+}
+
+.ref-selector-items {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+
+  li {
+    padding: 0.2rem 0;
+  }
+}
+
+.ref-selector-badge {
+  margin-left: 0.3rem;
+  font-size: 0.75rem;
+  opacity: 0.7;
+}
+
+.ref-selector-empty,
+.ref-selector-more {
+  padding: 0.2rem 0;
+  font-size: 0.85rem;
+}
+
+.latest-commit-placeholder {
+  opacity: 0.7;
+}
+
 .repo-info {
   .description {
     margin-bottom: .2rem;
diff --git a/cgithub/src/app.ts b/cgithub/src/app.ts
index 78b59ae..ca79b1f 100644
--- a/cgithub/src/app.ts
+++ b/cgithub/src/app.ts
@@ -5,8 +5,10 @@ import {
   getGitHubBlob,
   getGitHubCommits,
   getGitHubIssues,
+  getGitHubLatestCommit,
   getGitHubOwner,
   getGitHubPulls,
+  getGitHubRefs,
   getGitHubRelease,
   getGitHubReleases,
   getGitHubRepo,
@@ -44,6 +46,29 @@ export function createApp(eta: Eta) {
     return c.html(eta.render(template, data));
   }
 
+  // For fragments fetched asynchronously by client-side JS (see public/static/refs.js):
+  // errors render as an empty body rather than the full error.eta page.
+  async function tryRenderFragment<T extends object>(
+    c: Context,
+    template: string,
+    promise: Promise<T>,
+  ) {
+    let data: T;
+    try {
+      data = await promise;
+    } catch (e) {
+      const status =
+        e instanceof GitHubHTTPError
+          ? (e.status as StatusCode)
+          : e instanceof RedirectError
+            ? 404
+            : 500;
+      c.status(status);
+      return c.body(null);
+    }
+    return c.html(eta.render(template, data));
+  }
+
   app.get("/:owner", async (c) => {
     const { owner } = c.req.param();
     return tryRender(c, "owner.eta", getGitHubOwner(owner));
@@ -112,6 +137,27 @@ export function createApp(eta: Eta) {
     return tryRender(c, "commits.eta", getGitHubCommits(owner, repo, branch, path));
   });
 
+  // Internal endpoints fetched asynchronously by client-side JS, not meant to
+  // be visited directly. Keep the site's initial page loads plain server-
+  // rendered HTML while still surfacing data (branches/tags, latest commit)
+  // that would otherwise require an extra scrape on every page view.
+  app.get("/api/:owner/:repo/refs/:type", async (c) => {
+    const { owner, repo, type } = c.req.param();
+    if (type !== "branches" && type !== "tags") {
+      return c.notFound();
+    }
+    return tryRenderFragment(c, "_refs.eta", getGitHubRefs(owner, repo, type));
+  });
+
+  app.get("/api/:owner/:repo/latest-commit/:branch/:path{.*}?", async (c) => {
+    const { owner, repo, branch, path = "" } = c.req.param();
+    return tryRenderFragment(
+      c,
+      "_latestCommit.eta",
+      getGitHubLatestCommit(owner, repo, branch, path),
+    );
+  });
+
   app.get("/:owner/:repo/releases/tag/:tag", async (c) => {
     const { owner, repo, tag } = c.req.param();
     return tryRender(c, "release.eta", getGitHubRelease(owner, repo, tag));
diff --git a/cgithub/src/scraper.test.ts b/cgithub/src/scraper.test.ts
index f9b60e8..56f14b0 100644
--- a/cgithub/src/scraper.test.ts
+++ b/cgithub/src/scraper.test.ts
@@ -4,7 +4,9 @@ import {
   getGitHubBlob,
   getGitHubCommits,
   getGitHubIssues,
+  getGitHubLatestCommit,
   getGitHubPulls,
+  getGitHubRefs,
   getGitHubRelease,
   getGitHubReleases,
   getGitHubRepo,
@@ -205,6 +207,45 @@ describe("GitHub scraper", () => {
       assert.ok(firstRelease.bodyHtml.length > 0);
     });
 
+    it("should fetch latest commit for a path", async () => {
+      const data = await getGitHubLatestCommit("actions", "deploy-pages", "main", "src");
+
+      assert.strictEqual(data.repo.owner, "actions");
+      assert.strictEqual(data.repo.name, "deploy-pages");
+      assert.ok(data.commit);
+      assert.strictEqual(data.commit.oid.length, 40);
+      assert.ok(data.commit.shortMessageHtml.length > 0);
+      assert.ok(data.commit.date.length > 0);
+      assert.ok(data.commit.authors.length > 0);
+    });
+
+    it("should fetch branches", async () => {
+      const data = await getGitHubRefs("actions", "deploy-pages", "branches");
+
+      assert.strictEqual(data.repo.owner, "actions");
+      assert.strictEqual(data.repo.name, "deploy-pages");
+      assert.strictEqual(data.type, "branches");
+
+      assert.ok(data.refs.length > 0);
+      const main = data.refs.find((ref) => ref.name === "main");
+      assert.ok(main);
+      assert.strictEqual(main.isDefault, true);
+    });
+
+    it("should fetch tags", async () => {
+      const data = await getGitHubRefs("actions", "deploy-pages", "tags");
+
+      assert.strictEqual(data.repo.owner, "actions");
+      assert.strictEqual(data.repo.name, "deploy-pages");
+      assert.strictEqual(data.type, "tags");
+
+      assert.ok(data.refs.length > 0);
+      const tag = data.refs.find((ref) => ref.name === "v5.0.0");
+      assert.ok(tag);
+      assert.ok(tag.date?.length);
+      assert.strictEqual(data.hasMore, true);
+    });
+
     it("should fetch single release", async () => {
       const data = await getGitHubRelease("actions", "deploy-pages", "v4.0.5");
 
diff --git a/cgithub/src/scraper.ts b/cgithub/src/scraper.ts
index 53f2bb1..39ad2cd 100644
--- a/cgithub/src/scraper.ts
+++ b/cgithub/src/scraper.ts
@@ -70,7 +70,7 @@ interface IssueIndexPageQuery {
 
 type StylingDirective = [number, number, string];
 
-interface Commit {
+export interface Commit {
   oid: string;
   url: string;
   authoredDate: string;
@@ -270,6 +270,34 @@ export interface GitHubCommits extends GitHubNav {
   commitGroups: CommitGroup[];
 }
 
+export interface LatestCommit {
+  oid: string;
+  date: string;
+  shortMessageHtml: string;
+  authors: {
+    login: string;
+    displayName: string;
+    avatarUrl: string;
+  }[];
+}
+
+export interface GitHubLatestCommit extends GitHubCommon {
+  commit: LatestCommit;
+}
+
+export interface Ref {
+  name: string;
+  isDefault?: boolean;
+  date?: string;
+  authorLogin?: string;
+}
+
+export interface GitHubRefs extends GitHubCommon {
+  type: "branches" | "tags";
+  refs: Ref[];
+  hasMore: boolean;
+}
+
 interface Release {
   tagName: string;
   title: string;
@@ -325,13 +353,13 @@ export interface GitHubOwner {
   repos: OwnerRepo[];
 }
 
-async function fetchGitHubPage(path: string): Promise<string> {
+async function fetchGitHubResponse(path: string, accept: string): Promise<Response> {
   // GitHub throttles/blocks requests without realistic browser headers.
   // These headers make the request appear as a standard browser visit.
   const headers = {
     "User-Agent":
       "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36",
-    Accept: "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8",
+    Accept: accept,
     "Accept-Language": "en-US,en;q=0.5",
   };
   const response = await fetch(`https://github.com/${path}`, { headers, redirect: "manual" });
@@ -345,10 +373,25 @@ async function fetchGitHubPage(path: string): Promise<string> {
     }
   }
   if (!response.ok) throw new GitHubHTTPError(response.status, response.statusText);
+  return response;
+}
+
+async function fetchGitHubPage(path: string): Promise<string> {
+  const response = await fetchGitHubResponse(
+    path,
+    "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8",
+  );
   return response.text();
 }
 
-function parsePayload(html: string): AppPayload | null {
+// Some routes (e.g. latest-commit) are the same endpoints the React UI itself
+// calls to lazily fill in data; they 406 without an explicit JSON Accept.
+async function fetchGitHubJson<T>(path: string): Promise<T> {
+  const response = await fetchGitHubResponse(path, "application/json");
+  return (await response.json()) as T;
+}
+
+function parseEmbeddedPayload<T>(html: string): T | null {
   const regex = new RegExp(
     `<script type="application/json" data-target="react-app.embeddedData">([^<]+)</script>`,
     "g",
@@ -367,6 +410,10 @@ function parsePayload(html: string): AppPayload | null {
   return null;
 }
 
+function parsePayload(html: string): AppPayload | null {
+  return parseEmbeddedPayload<AppPayload>(html);
+}
+
 function parseRepoInfo(html: string): RepoInfo {
   const document = parseDocument(html);
 
@@ -639,6 +686,121 @@ export async function getGitHubCommits(
   };
 }
 
+interface LatestCommitPayload {
+  oid: string;
+  date: string;
+  shortMessageHtmlLink: string;
+  authors: {
+    login: string;
+    displayName: string;
+    avatarUrl: string;
+  }[];
+}
+
+// This is the same endpoint the React UI itself calls to lazily fill in the
+// commit bar above a file listing, rather than the much heavier /commits
+// history page: it returns just the single latest commit as JSON.
+export async function getGitHubLatestCommit(
+  owner: string,
+  repo: string,
+  branch: string,
+  path: string,
+): Promise<GitHubLatestCommit> {
+  const urlPath = path
+    ? `${owner}/${repo}/latest-commit/${branch}/${path}`
+    : `${owner}/${repo}/latest-commit/${branch}`;
+  const payload = await fetchGitHubJson<LatestCommitPayload>(urlPath);
+
+  return {
+    repo: { owner, name: repo },
+    commit: {
+      oid: payload.oid,
+      date: payload.date,
+      shortMessageHtml: payload.shortMessageHtmlLink,
+      authors: payload.authors,
+    },
+  };
+}
+
+interface BranchRefEntry {
+  name: string;
+  isDefault: boolean;
+  authoredDate?: string;
+  author?: { login: string };
+}
+
+interface BranchesPayload {
+  branches: {
+    default?: BranchRefEntry;
+    yours?: BranchRefEntry[];
+    active?: BranchRefEntry[];
+    stale?: BranchRefEntry[];
+  };
+  hasMore?: Record<string, boolean>;
+}
+
+async function getGitHubBranchRefs(owner: string, repo: string): Promise<GitHubRefs> {
+  const html = await fetchGitHubPage(`${owner}/${repo}/branches`);
+  const payload = parseEmbeddedPayload<BranchesPayload>(html);
+
+  if (payload?.branches === undefined) {
+    throw new Error("Could not find branches data in embedded JSON");
+  }
+
+  const { default: defaultBranch, yours = [], active = [], stale = [] } = payload.branches;
+  const entries = [...(defaultBranch ? [defaultBranch] : []), ...yours, ...active, ...stale];
+
+  const seen = new Set<string>();
+  const refs: Ref[] = [];
+  for (const entry of entries) {
+    if (seen.has(entry.name)) continue;
+    seen.add(entry.name);
+    refs.push({
+      name: entry.name,
+      isDefault: entry.isDefault || undefined,
+      date: entry.authoredDate,
+      authorLogin: entry.author?.login,
+    });
+  }
+
+  const hasMore = Object.values(payload.hasMore ?? {}).some(Boolean);
+
+  return { repo: { owner, name: repo }, type: "branches", refs, hasMore };
+}
+
+async function getGitHubTagRefs(owner: string, repo: string): Promise<GitHubRefs> {
+  const html = await fetchGitHubPage(`${owner}/${repo}/tags`);
+  const document = parseDocument(html);
+
+  const refs: Ref[] = [];
+  for (const row of cssSelect.selectAll(".Box-row", document) as unknown as Element[]) {
+    const nameElem = cssSelect.selectOne("h2 a", row);
+    if (!nameElem) continue;
+    const name = textContent(nameElem).trim();
+    if (!name) continue;
+
+    // The row has two <relative-time> elements: a release/tag creation
+    // timestamp, then the tagged commit's authored date. We want the latter.
+    const timeElems = cssSelect.selectAll("relative-time", row);
+    const timeElem = timeElems[1] as Element | undefined;
+    const date = timeElem ? getAttributeValue(timeElem, "datetime") || undefined : undefined;
+
+    refs.push({ name, date });
+  }
+
+  const hasMore = cssSelect.selectOne(".pagination a", document) !== null;
+
+  return { repo: { owner, name: repo }, type: "tags", refs, hasMore };
+}
+
+export async function getGitHubRefs(
+  owner: string,
+  repo: string,
+  type: "branches" | "tags",
+): Promise<GitHubRefs> {
+  return type === "branches" ? getGitHubBranchRefs(owner, repo) : getGitHubTagRefs(owner, repo);
+}
+
 function parseRelease(section: Element, title: string): Release {
   // Extract tag name from link
   const tagLink = cssSelect.selectOne('a[href*="/tree/"]', section);
@@ -867,9 +1029,10 @@ function parseUser(document: AnyNode, login: string): GitHubOwner {
 }
 
 function parseOrganization(document: AnyNode, owner: string): GitHubOwner {
-  const avatarElem = cssSelect.selectOne(".orghead img[itemprop='image']", document) as
-    | Element
-    | null;
+  const avatarElem = cssSelect.selectOne(
+    ".orghead img[itemprop='image']",
+    document,
+  ) as Element | null;
   const avatarUrl = avatarElem ? getAttributeValue(avatarElem, "src") || null : null;
   // The login only appears in the avatar's "@login" alt text.
   const alt = avatarElem ? getAttributeValue(avatarElem, "alt") : undefined;
diff --git a/cgithub/views/_latestCommit.eta b/cgithub/views/_latestCommit.eta
new file mode 100644
index 0000000..18d22a1
--- /dev/null
+++ b/cgithub/views/_latestCommit.eta
@@ -0,0 +1,16 @@
+<div class="commit box">
+  <div>
+    <div>
+      <%~ it.commit.shortMessageHtml %>
+    </div>
+    <div class="commit-author">
+      <% for (const author of it.commit.authors) { %>
+        <a href="/<%= author.login %>"><%= author.login %></a>
+      <% } %>
+      <time class="timestamp" title="<%= it.commit.date %>"><%= it.commit.date.split("T")[0] %></time>
+    </div>
+  </div>
+  <div class="commit-sha">
+    <code><%= it.commit.oid.substring(0, 7) %></code>
+  </div>
+</div>
diff --git a/cgithub/views/_nav.eta b/cgithub/views/_nav.eta
index 338a6a6..e3fbdcf 100644
--- a/cgithub/views/_nav.eta
+++ b/cgithub/views/_nav.eta
@@ -1,5 +1,14 @@
 <section>
-  <div class="branch"><img src="/static/icons/git-branch.svg" alt="branch" class="icon"> <%= it.branch %></div>
+  <button type="button" class="ref-selector-button branch" command="show-modal" commandfor="ref-selector-menu">
+    <img src="/static/icons/git-branch.svg" alt="branch" class="icon"> <%= it.branch %> ▾
+  </button>
+  <dialog class="ref-selector-menu" id="ref-selector-menu" closedby="any" data-owner="<%= it.repo.owner %>" data-repo="<%= it.repo.name %>">
+    <div class="ref-selector-tabs">
+      <button type="button" class="active" data-ref-type="branches">Branches</button>
+      <button type="button" data-ref-type="tags">Tags</button>
+    </div>
+    <div class="ref-selector-list">Loading…</div>
+  </dialog>
   <% if (it.path && it.path !== "/") { %>
     <a href="/<%= it.repo.owner %>/<%= it.repo.name %>/tree/<%= it.branch %>">(top)</a><%
     const pathParts = it.path.split('/').filter(p => p);
diff --git a/cgithub/views/_refs.eta b/cgithub/views/_refs.eta
new file mode 100644
index 0000000..2450c4b
--- /dev/null
+++ b/cgithub/views/_refs.eta
@@ -0,0 +1,17 @@
+<% if (it.refs.length === 0) { %>
+  <div class="ref-selector-empty">No <%= it.type %> found.</div>
+<% } else { %>
+  <ul class="ref-selector-items">
+    <% for (const ref of it.refs) { %>
+      <li>
+        <a href="/<%= it.repo.owner %>/<%= it.repo.name %>/tree/<%= ref.name %>"><%= ref.name %></a>
+        <% if (ref.isDefault) { %><span class="ref-selector-badge">default</span><% } %>
+      </li>
+    <% } %>
+  </ul>
+<% } %>
+<% if (it.hasMore) { %>
+  <div class="ref-selector-more">
+    <a href="/<%= it.repo.owner %>/<%= it.repo.name %>/<%= it.type %>">View all <%= it.type %></a>
+  </div>
+<% } %>
diff --git a/cgithub/views/_tree.eta b/cgithub/views/_tree.eta
index ed6eee9..a0ecfab 100644
--- a/cgithub/views/_tree.eta
+++ b/cgithub/views/_tree.eta
@@ -1,5 +1,8 @@
 <%~ include("./_nav.eta", {...it, isTree: true}) %>
 
+<% const commitPath = it.path && it.path !== "/" ? it.path : ""; %>
+<div class="latest-commit-placeholder box" data-src="/api/<%= it.repo.owner %>/<%= it.repo.name %>/latest-commit/<%= it.branch %>/<%= commitPath %>">Loading latest commit…</div>
+
 <table>
   <% for (const item of it.items) { %>
     <tr>
diff --git a/cgithub/views/layout.eta b/cgithub/views/layout.eta
index dd523d1..a80bd1d 100644
--- a/cgithub/views/layout.eta
+++ b/cgithub/views/layout.eta
@@ -5,6 +5,7 @@
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <title><%= it.repo.owner %>/<%= it.repo.name %> - <%= it.path || '/' %></title>
   <link rel="stylesheet" href="/static/style.css">
+  <script src="/static/refs.js" defer></script>
 </head>
 <body>
   <div class="box">
-- 
cgit v1.3.1


From 0be1fdd2635fbc49d7451d3711b5772e1e9990e2 Mon Sep 17 00:00:00 2001
From: Joe Mou <dev@mou.fo>
Date: Tue, 11 Aug 2026 08:09:47 -0400
Subject: Add language percentages to repo pages

GitHub no longer server-renders the repository sidebar; its React UI
lazily fetches /:owner/:repo/_sidebar as JSON, which carries the
language breakdown (name, percentage, color). getGitHubLanguages() uses
that endpoint, and a new /api/:owner/:repo/languages fragment route
renders the bar and legend the same way refs and latest-commit already
work, so repo page loads still cost a single scrape.

The latest-commit placeholder loader in refs.js is generalized over
.placeholder[data-src] so both placeholders share it.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
---
 cgithub/public/static/refs.js   | 21 ++++++++++-----------
 cgithub/public/static/style.css | 37 ++++++++++++++++++++++++++++++++++++-
 cgithub/src/app.ts              |  6 ++++++
 cgithub/src/scraper.test.ts     | 28 ++++++++++++++++++++++++++++
 cgithub/src/scraper.ts          | 39 +++++++++++++++++++++++++++++++++++++++
 cgithub/views/_languages.eta    | 17 +++++++++++++++++
 cgithub/views/_tree.eta         |  2 +-
 cgithub/views/repo.eta          |  2 ++
 8 files changed, 139 insertions(+), 13 deletions(-)
 create mode 100644 cgithub/views/_languages.eta

(limited to 'cgithub/src/app.ts')

diff --git a/cgithub/public/static/refs.js b/cgithub/public/static/refs.js
index 28b8373..ffff505 100644
--- a/cgithub/public/static/refs.js
+++ b/cgithub/public/static/refs.js
@@ -1,8 +1,8 @@
-// Progressive enhancement for two bits of data GitHub itself loads lazily:
-// the branch/tag dropdown and the latest-commit bar above a file listing.
-// Both degrade gracefully without JS: the button's command/commandfor still
-// opens the (empty) dialog natively; the commit placeholder just never fills
-// in.
+// Progressive enhancement for the bits of data GitHub itself loads lazily:
+// the branch/tag dropdown, the latest-commit bar above a file listing, and the
+// language breakdown. All degrade gracefully without JS: the button's
+// command/commandfor still opens the (empty) dialog natively; the placeholders
+// just never fill in.
 document.addEventListener("DOMContentLoaded", () => {
   const dialog = document.querySelector(".ref-selector-menu");
   if (dialog) {
@@ -44,17 +44,16 @@ document.addEventListener("DOMContentLoaded", () => {
     }
   }
 
-  const commitPlaceholder = document.querySelector(".latest-commit-placeholder");
-  if (commitPlaceholder) {
-    fetch(commitPlaceholder.dataset.src)
+  for (const placeholder of document.querySelectorAll(".placeholder[data-src]")) {
+    fetch(placeholder.dataset.src)
       .then((res) => (res.ok ? res.text() : ""))
       .then((html) => {
         if (html.trim()) {
-          commitPlaceholder.outerHTML = html;
+          placeholder.outerHTML = html;
         } else {
-          commitPlaceholder.remove();
+          placeholder.remove();
         }
       })
-      .catch(() => commitPlaceholder.remove());
+      .catch(() => placeholder.remove());
   }
 });
diff --git a/cgithub/public/static/style.css b/cgithub/public/static/style.css
index 983cb86..ed64bc6 100644
--- a/cgithub/public/static/style.css
+++ b/cgithub/public/static/style.css
@@ -218,10 +218,45 @@ body > footer {
   font-size: 0.85rem;
 }
 
-.latest-commit-placeholder {
+.placeholder {
   opacity: 0.7;
 }
 
+.languages {
+  .language-bar {
+    display: flex;
+    height: .5rem;
+    border-radius: .25rem;
+    overflow: hidden;
+
+    span {
+      /* Keep slivers of tiny languages visible. */
+      min-width: 1px;
+    }
+  }
+
+  .language-list {
+    display: flex;
+    flex-wrap: wrap;
+    gap: .2rem 1rem;
+    list-style: none;
+    margin: .5rem 0 0;
+    padding: 0;
+    font-size: 0.85rem;
+  }
+
+  .language-dot {
+    display: inline-block;
+    width: .6rem;
+    height: .6rem;
+    border-radius: 50%;
+  }
+
+  .language-percentage {
+    opacity: 0.7;
+  }
+}
+
 .repo-info {
   .description {
     margin-bottom: .2rem;
diff --git a/cgithub/src/app.ts b/cgithub/src/app.ts
index ca79b1f..e34c7b1 100644
--- a/cgithub/src/app.ts
+++ b/cgithub/src/app.ts
@@ -5,6 +5,7 @@ import {
   getGitHubBlob,
   getGitHubCommits,
   getGitHubIssues,
+  getGitHubLanguages,
   getGitHubLatestCommit,
   getGitHubOwner,
   getGitHubPulls,
@@ -158,6 +159,11 @@ export function createApp(eta: Eta) {
     );
   });
 
+  app.get("/api/:owner/:repo/languages", async (c) => {
+    const { owner, repo } = c.req.param();
+    return tryRenderFragment(c, "_languages.eta", getGitHubLanguages(owner, repo));
+  });
+
   app.get("/:owner/:repo/releases/tag/:tag", async (c) => {
     const { owner, repo, tag } = c.req.param();
     return tryRender(c, "release.eta", getGitHubRelease(owner, repo, tag));
diff --git a/cgithub/src/scraper.test.ts b/cgithub/src/scraper.test.ts
index 56f14b0..5b5e78b 100644
--- a/cgithub/src/scraper.test.ts
+++ b/cgithub/src/scraper.test.ts
@@ -4,6 +4,7 @@ import {
   getGitHubBlob,
   getGitHubCommits,
   getGitHubIssues,
+  getGitHubLanguages,
   getGitHubLatestCommit,
   getGitHubPulls,
   getGitHubRefs,
@@ -219,6 +220,33 @@ describe("GitHub scraper", () => {
       assert.ok(data.commit.authors.length > 0);
     });
 
+    it("should fetch languages", async () => {
+      const data = await getGitHubLanguages("actions", "deploy-pages");
+
+      assert.strictEqual(data.repo.owner, "actions");
+      assert.strictEqual(data.repo.name, "deploy-pages");
+
+      assert.deepStrictEqual(data.languages, [
+        { name: "JavaScript", percentage: 100, color: "#f1e05a" },
+      ]);
+    });
+
+    it("should fetch languages for a multi-language repository", async () => {
+      const data = await getGitHubLanguages("rust-lang", "rust");
+
+      const rust = data.languages.find((language) => language.name === "Rust");
+      assert.ok(rust);
+      assert.ok(rust.percentage > 50);
+      assert.strictEqual(rust.color, "#dea584");
+
+      // The aggregate bucket comes back without a name.
+      const other = data.languages.find((language) => language.name === "Other");
+      assert.ok(other);
+
+      const total = data.languages.reduce((sum, language) => sum + language.percentage, 0);
+      assert.ok(Math.abs(total - 100) < 1);
+    });
+
     it("should fetch branches", async () => {
       const data = await getGitHubRefs("actions", "deploy-pages", "branches");
 
diff --git a/cgithub/src/scraper.ts b/cgithub/src/scraper.ts
index 39ad2cd..223839f 100644
--- a/cgithub/src/scraper.ts
+++ b/cgithub/src/scraper.ts
@@ -285,6 +285,17 @@ export interface GitHubLatestCommit extends GitHubCommon {
   commit: LatestCommit;
 }
 
+export interface Language {
+  // "Other" for the aggregate bucket GitHub reports without a name.
+  name: string;
+  percentage: number;
+  color: string | null;
+}
+
+export interface GitHubLanguages extends GitHubCommon {
+  languages: Language[];
+}
+
 export interface Ref {
   name: string;
   isDefault?: boolean;
@@ -722,6 +733,34 @@ export async function getGitHubLatestCommit(
   };
 }
 
+interface SidebarPayload {
+  languages?: {
+    languages: {
+      // Absent for the "Other" bucket.
+      name?: string;
+      percentage: number;
+      color?: string;
+    }[];
+  };
+}
+
+// The repository sidebar (languages, contributors, ...) is not rendered into
+// the repo page at all; GitHub's own UI lazily fetches it as JSON from here.
+export async function getGitHubLanguages(owner: string, repo: string): Promise<GitHubLanguages> {
+  const payload = await fetchGitHubJson<SidebarPayload>(`${owner}/${repo}/_sidebar`);
+
+  const languages: Language[] = [];
+  for (const entry of payload.languages?.languages ?? []) {
+    languages.push({
+      name: entry.name ?? "Other",
+      percentage: entry.percentage,
+      color: entry.color ?? null,
+    });
+  }
+
+  return { repo: { owner, name: repo }, languages };
+}
+
 interface BranchRefEntry {
   name: string;
   isDefault: boolean;
diff --git a/cgithub/views/_languages.eta b/cgithub/views/_languages.eta
new file mode 100644
index 0000000..8aca447
--- /dev/null
+++ b/cgithub/views/_languages.eta
@@ -0,0 +1,17 @@
+<% if (it.languages.length > 0) { %>
+  <div class="languages box">
+    <div class="language-bar">
+      <% for (const lang of it.languages) { %>
+        <span style="width: <%= lang.percentage %>%; background: <%= lang.color ?? "#ededed" %>" title="<%= lang.name %> <%= lang.percentage %>%"></span>
+      <% } %>
+    </div>
+    <ul class="language-list">
+      <% for (const lang of it.languages) { %>
+        <li>
+          <span class="language-dot" style="background: <%= lang.color ?? "#ededed" %>"></span>
+          <%= lang.name %> <span class="language-percentage"><%= lang.percentage %>%</span>
+        </li>
+      <% } %>
+    </ul>
+  </div>
+<% } %>
diff --git a/cgithub/views/_tree.eta b/cgithub/views/_tree.eta
index a0ecfab..2eb445f 100644
--- a/cgithub/views/_tree.eta
+++ b/cgithub/views/_tree.eta
@@ -1,7 +1,7 @@
 <%~ include("./_nav.eta", {...it, isTree: true}) %>
 
 <% const commitPath = it.path && it.path !== "/" ? it.path : ""; %>
-<div class="latest-commit-placeholder box" data-src="/api/<%= it.repo.owner %>/<%= it.repo.name %>/latest-commit/<%= it.branch %>/<%= commitPath %>">Loading latest commit…</div>
+<div class="placeholder box" data-src="/api/<%= it.repo.owner %>/<%= it.repo.name %>/latest-commit/<%= it.branch %>/<%= commitPath %>">Loading latest commit…</div>
 
 <table>
   <% for (const item of it.items) { %>
diff --git a/cgithub/views/repo.eta b/cgithub/views/repo.eta
index 683a9ad..9122594 100644
--- a/cgithub/views/repo.eta
+++ b/cgithub/views/repo.eta
@@ -29,4 +29,6 @@
   </div>
 <% } %>
 
+<div class="placeholder box" data-src="/api/<%= it.repo.owner %>/<%= it.repo.name %>/languages">Loading languages…</div>
+
 <%~ include("./_tree", it) %>
-- 
cgit v1.3.1


From 9cef0850f8049a8f1cb11097852738de4cad4a30 Mon Sep 17 00:00:00 2001
From: Joe Mou <dev@mou.fo>
Date: Tue, 11 Aug 2026 08:17:54 -0400
Subject: Link repo header and add a "View original" link
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The owner/name header in the layout now links to the owner page and the
repository root. tryRender passes the request's path and query through
as githubUrl — our URLs mirror GitHub's, so the same path is the page we
scraped — and the footer links there with rel="noreferrer", matching the
no-referrer policy used on redirects to github.com.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
---
 cgithub/src/app.ts       | 5 ++++-
 cgithub/views/layout.eta | 4 ++--
 2 files changed, 6 insertions(+), 3 deletions(-)

(limited to 'cgithub/src/app.ts')

diff --git a/cgithub/src/app.ts b/cgithub/src/app.ts
index e34c7b1..5bed45d 100644
--- a/cgithub/src/app.ts
+++ b/cgithub/src/app.ts
@@ -44,7 +44,10 @@ export function createApp(eta: Eta) {
         return c.html(eta.render("error.eta", { message: "" + e }));
       }
     }
-    return c.html(eta.render(template, data));
+    // Our URLs mirror GitHub's, so the page we scraped is the same path there.
+    const { pathname, search } = new URL(c.req.url);
+    const githubUrl = `https://github.com${pathname}${search}`;
+    return c.html(eta.render(template, { ...data, githubUrl }));
   }
 
   // For fragments fetched asynchronously by client-side JS (see public/static/refs.js):
diff --git a/cgithub/views/layout.eta b/cgithub/views/layout.eta
index a80bd1d..f803caf 100644
--- a/cgithub/views/layout.eta
+++ b/cgithub/views/layout.eta
@@ -9,7 +9,7 @@
 </head>
 <body>
   <div class="box">
-    <div class="repo"><%= it.repo.owner %>/<%= it.repo.name %></div>
+    <div class="repo"><a href="/<%= it.repo.owner %>"><%= it.repo.owner %></a>/<a href="/<%= it.repo.owner %>/<%= it.repo.name %>"><%= it.repo.name %></a></div>
     <pre><code>git clone https://github.com/<%= it.repo.owner %>/<%= it.repo.name %>.git
 git clone git@github.com:<%= it.repo.owner %>/<%= it.repo.name %>.git</code></pre>
     <nav>
@@ -34,7 +34,7 @@ git clone git@github.com:<%= it.repo.owner %>/<%= it.repo.name %>.git</code></pr
 
   <%~ it.body %>
 
-  <footer>Generated by cgithub</footer>
+  <footer>Generated by cgithub · <a href="<%= it.githubUrl %>" rel="noreferrer">View original</a></footer>
 
   <script>
     document.addEventListener("keydown", function(e) {
-- 
cgit v1.3.1


From ab52f48e50d0dd242ad5b0cfbee9c458946cd427 Mon Sep 17 00:00:00 2001
From: Joe Mou <dev@mou.fo>
Date: Tue, 11 Aug 2026 08:37:25 -0400
Subject: Show the build's commit in the page footer

Workers can't shell out at request time, so the commit has to be baked
in before wrangler bundles the sources. compile-views.ts grows a second
job and becomes scripts/build.ts: alongside the precompiled views it
writes src/commit.generated.ts with `git describe --tags --always
--dirty`, which yields a bare short hash until the repo is tagged and
marks builds made from an unclean working copy.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
---
 cgithub/.gitignore               |  1 +
 cgithub/CLAUDE.md                |  2 +-
 cgithub/package.json             |  4 ++--
 cgithub/scripts/build.ts         | 52 ++++++++++++++++++++++++++++++++++++++++
 cgithub/scripts/compile-views.ts | 29 ----------------------
 cgithub/src/app.ts               |  3 ++-
 cgithub/src/worker.ts            |  2 +-
 cgithub/views/layout.eta         |  2 +-
 8 files changed, 60 insertions(+), 35 deletions(-)
 create mode 100644 cgithub/scripts/build.ts
 delete mode 100644 cgithub/scripts/compile-views.ts

(limited to 'cgithub/src/app.ts')

diff --git a/cgithub/.gitignore b/cgithub/.gitignore
index 5a5e404..b8fc600 100644
--- a/cgithub/.gitignore
+++ b/cgithub/.gitignore
@@ -1,3 +1,4 @@
 /node_modules/
 /.wrangler/
+/src/commit.generated.ts
 /src/views.generated.ts
diff --git a/cgithub/CLAUDE.md b/cgithub/CLAUDE.md
index 37774cc..0ef4b47 100644
--- a/cgithub/CLAUDE.md
+++ b/cgithub/CLAUDE.md
@@ -24,7 +24,7 @@ pnpm test
 - `src/worker.ts` - Cloudflare Workers entry (config in `wrangler.jsonc`)
 - `src/scraper.ts` - GitHub HTML fetching and JSON extraction logic
 
-**Templates:** `views/*.eta` - Eta templates with layout inheritance (`layout.eta` as base). On Workers, runtime code generation is disallowed, so `scripts/compile-views.ts` precompiles templates to `src/views.generated.ts` (gitignored, regenerated by the `dev`/`deploy` scripts).
+**Templates:** `views/*.eta` - Eta templates with layout inheritance (`layout.eta` as base). On Workers, runtime code generation is disallowed, so `scripts/build.ts` precompiles templates to `src/views.generated.ts`. The same script records the build's `git describe` output in `src/commit.generated.ts` for the page footer. Both are gitignored and regenerated by the `dev`/`deploy` scripts.
 
 **Static files:** `public/static/*`, served by Workers Static Assets.
 
diff --git a/cgithub/package.json b/cgithub/package.json
index 337fabc..7673612 100644
--- a/cgithub/package.json
+++ b/cgithub/package.json
@@ -5,8 +5,8 @@
   "license": "MIT",
   "type": "module",
   "scripts": {
-    "dev": "node scripts/compile-views.ts && wrangler dev",
-    "deploy": "node scripts/compile-views.ts && wrangler deploy",
+    "dev": "node scripts/build.ts && wrangler dev",
+    "deploy": "node scripts/build.ts && wrangler deploy",
     "test": "node --test --test-concurrency=4 src/scraper.test.ts"
   },
   "dependencies": {
diff --git a/cgithub/scripts/build.ts b/cgithub/scripts/build.ts
new file mode 100644
index 0000000..766e5e8
--- /dev/null
+++ b/cgithub/scripts/build.ts
@@ -0,0 +1,52 @@
+// Generates the sources that can't exist at runtime on Workers:
+//
+//   src/views.generated.ts  - views/*.eta precompiled into plain functions.
+//     Workers disallow runtime code generation (`new Function`), so Eta cannot
+//     compile templates there at request time.
+//   src/commit.generated.ts - the commit this build was made from, for the
+//     page footer. Workers can't shell out to git at request time either.
+import { execFileSync } from "node:child_process";
+import { Eta } from "eta";
+import fs from "node:fs";
+import path from "node:path";
+
+const root = path.join(import.meta.dirname, "..");
+const viewsDir = path.join(root, "views");
+const eta = new Eta({ views: viewsDir });
+
+const names = fs
+  .readdirSync(viewsDir)
+  .filter((name) => name.endsWith(".eta"))
+  .sort();
+
+let out = `// @ts-nocheck
+// Generated by scripts/build.ts -- do not edit.
+export const views = {
+`;
+for (const name of names) {
+  const source = fs.readFileSync(path.join(viewsDir, name), "utf8");
+  const body = eta.compileToString(source);
+  out += `  ${JSON.stringify(name)}: function (it, options) {\n${body}\n  },\n`;
+}
+out += "};\n";
+
+fs.writeFileSync(path.join(root, "src", "views.generated.ts"), out);
+console.log(`Compiled ${names.length} templates to src/views.generated.ts`);
+
+// Untagged repositories describe as a bare short hash; --dirty marks a build
+// made from an unclean working copy.
+let commit = "unknown";
+try {
+  commit = execFileSync("git", ["describe", "--tags", "--always", "--dirty"], {
+    cwd: root,
+    encoding: "utf8",
+  }).trim();
+} catch {
+  // Building from a source copy without git history.
+}
+
+fs.writeFileSync(
+  path.join(root, "src", "commit.generated.ts"),
+  `// Generated by scripts/build.ts -- do not edit.\nexport const commit = ${JSON.stringify(commit)};\n`,
+);
+console.log(`Wrote commit ${commit} to src/commit.generated.ts`);
diff --git a/cgithub/scripts/compile-views.ts b/cgithub/scripts/compile-views.ts
deleted file mode 100644
index 785efc1..0000000
--- a/cgithub/scripts/compile-views.ts
+++ /dev/null
@@ -1,29 +0,0 @@
-// Precompiles views/*.eta into plain functions for the Cloudflare Workers
-// build (src/views.generated.ts). Workers disallow runtime code generation
-// (`new Function`), so Eta cannot compile templates there at request time.
-import { Eta } from "eta";
-import fs from "node:fs";
-import path from "node:path";
-
-const root = path.join(import.meta.dirname, "..");
-const viewsDir = path.join(root, "views");
-const eta = new Eta({ views: viewsDir });
-
-const names = fs
-  .readdirSync(viewsDir)
-  .filter((name) => name.endsWith(".eta"))
-  .sort();
-
-let out = `// @ts-nocheck
-// Generated by scripts/compile-views.ts -- do not edit.
-export const views = {
-`;
-for (const name of names) {
-  const source = fs.readFileSync(path.join(viewsDir, name), "utf8");
-  const body = eta.compileToString(source);
-  out += `  ${JSON.stringify(name)}: function (it, options) {\n${body}\n  },\n`;
-}
-out += "};\n";
-
-fs.writeFileSync(path.join(root, "src", "views.generated.ts"), out);
-console.log(`Compiled ${names.length} templates to src/views.generated.ts`);
diff --git a/cgithub/src/app.ts b/cgithub/src/app.ts
index 5bed45d..0218918 100644
--- a/cgithub/src/app.ts
+++ b/cgithub/src/app.ts
@@ -1,6 +1,7 @@
 import type { Eta } from "eta";
 import { type Context, Hono } from "hono";
 import type { StatusCode } from "hono/utils/http-status";
+import { commit } from "./commit.generated.ts";
 import {
   getGitHubBlob,
   getGitHubCommits,
@@ -47,7 +48,7 @@ export function createApp(eta: Eta) {
     // Our URLs mirror GitHub's, so the page we scraped is the same path there.
     const { pathname, search } = new URL(c.req.url);
     const githubUrl = `https://github.com${pathname}${search}`;
-    return c.html(eta.render(template, { ...data, githubUrl }));
+    return c.html(eta.render(template, { ...data, githubUrl, commit }));
   }
 
   // For fragments fetched asynchronously by client-side JS (see public/static/refs.js):
diff --git a/cgithub/src/worker.ts b/cgithub/src/worker.ts
index 024b01a..7bf9100 100644
--- a/cgithub/src/worker.ts
+++ b/cgithub/src/worker.ts
@@ -5,7 +5,7 @@ import { createApp } from "./app.ts";
 import { views } from "./views.generated.ts";
 
 // Workers disallow runtime code generation, so templates are precompiled by
-// scripts/compile-views.ts and preloaded into Eta's cache here. With
+// scripts/build.ts and preloaded into Eta's cache here. With
 // cache: true, Eta serves them from the cache and never compiles.
 const eta = new Eta({ cache: true });
 
diff --git a/cgithub/views/layout.eta b/cgithub/views/layout.eta
index f803caf..ca6fff2 100644
--- a/cgithub/views/layout.eta
+++ b/cgithub/views/layout.eta
@@ -34,7 +34,7 @@ git clone git@github.com:<%= it.repo.owner %>/<%= it.repo.name %>.git</code></pr
 
   <%~ it.body %>
 
-  <footer>Generated by cgithub · <a href="<%= it.githubUrl %>" rel="noreferrer">View original</a></footer>
+  <footer>Generated by cgithub commit <code><%= it.commit %></code> · <a href="<%= it.githubUrl %>" rel="noreferrer">View original</a></footer>
 
   <script>
     document.addEventListener("keydown", function(e) {
-- 
cgit v1.3.1


From 9731ebd1bece1187f943a29da474f4aed6e7ee3b Mon Sep 17 00:00:00 2001
From: Joe Mou <dev@mou.fo>
Date: Tue, 11 Aug 2026 11:39:01 -0400
Subject: Redirect to GitHub with a meta refresh

A browser extension redirects github.com to cgithub with declarative net
requests. Its rules match our HTTP redirects back to github.com too, so
those bounce straight back here and loop forever. A meta refresh makes
cgithub the initiator origin instead, which the extension's rules can
exclude, and its delay leaves a page the user can stop on.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
---
 cgithub/README.md          | 30 ++++++++++++++++++++++++++++
 cgithub/package.json       |  6 ++++--
 cgithub/src/app.test.ts    | 50 ++++++++++++++++++++++++++++++++++++++++++++++
 cgithub/src/app.ts         | 35 +++++++++++++++++++-------------
 cgithub/views/redirect.eta | 14 +++++++++++++
 5 files changed, 119 insertions(+), 16 deletions(-)
 create mode 100644 cgithub/src/app.test.ts
 create mode 100644 cgithub/views/redirect.eta

(limited to 'cgithub/src/app.ts')

diff --git a/cgithub/README.md b/cgithub/README.md
index 3bcf017..a625116 100644
--- a/cgithub/README.md
+++ b/cgithub/README.md
@@ -24,6 +24,36 @@ $ pnpm run deploy
 
 The worker name and other settings live in `wrangler.jsonc`.
 
+## Browser extension redirects
+
+Pages cgithub can't render (marketing pages, code search, anything unrouted) are
+redirected back to github.com. A browser extension that rewrites github.com URLs
+to a cgithub instance with `declarativeNetRequest` will match those redirects
+too and send the request straight back, looping forever.
+
+To avoid this, cgithub never answers with an HTTP redirect: it serves a small
+page that navigates to github.com with a two-second `<meta http-equiv="refresh">`.
+Because that navigation is initiated by the cgithub origin, the extension can
+let it through with `excludedInitiatorDomains`; without that, the user at least
+lands on a page they can stop on, with a link, instead of an endless loop.
+
+A rule that redirects to a cgithub instance should therefore look like this:
+
+```jsonc
+{
+  "action": {
+    "type": "redirect",
+    "redirect": { "transform": { "host": "cgithub.example" } },
+  },
+  "condition": {
+    "urlFilter": "||github.com",
+    "resourceTypes": ["main_frame"],
+    // So cgithub's own meta refresh to github.com isn't redirected back here.
+    "excludedInitiatorDomains": ["cgithub.example"],
+  },
+}
+```
+
 ## Disclosures
 
 AI coding assistants, in particular Claude, are used in the development process.
diff --git a/cgithub/package.json b/cgithub/package.json
index 7673612..ce25701 100644
--- a/cgithub/package.json
+++ b/cgithub/package.json
@@ -7,7 +7,7 @@
   "scripts": {
     "dev": "node scripts/build.ts && wrangler dev",
     "deploy": "node scripts/build.ts && wrangler deploy",
-    "test": "node --test --test-concurrency=4 src/scraper.test.ts"
+    "test": "node --test --test-concurrency=4 src/app.test.ts src/scraper.test.ts"
   },
   "dependencies": {
     "css-select": "^6.0.0",
@@ -18,7 +18,9 @@
     "htmlparser2": "^10.1.0"
   },
   "pnpm": {
-    "onlyBuiltDependencies": ["workerd"]
+    "onlyBuiltDependencies": [
+      "workerd"
+    ]
   },
   "devDependencies": {
     "@types/node": "^22.10.2",
diff --git a/cgithub/src/app.test.ts b/cgithub/src/app.test.ts
new file mode 100644
index 0000000..498d8a6
--- /dev/null
+++ b/cgithub/src/app.test.ts
@@ -0,0 +1,50 @@
+import assert from "node:assert";
+import path from "node:path";
+import { describe, it } from "node:test";
+import { Eta } from "eta";
+import { createApp } from "./app.ts";
+
+// The routes exercised here redirect without scraping, so no network is needed.
+const eta = new Eta({ views: path.join(import.meta.dirname, "..", "views") });
+const app = createApp(eta);
+
+describe("redirects to GitHub", () => {
+  // An HTTP redirect would be caught by the extension's declarativeNetRequest
+  // rules and bounced straight back here.
+  it("should redirect unknown paths with a meta refresh", async () => {
+    const res = await app.request("http://cgithub.example/a/b/c?x=1");
+
+    assert.strictEqual(res.status, 200);
+    assert.strictEqual(res.headers.get("location"), null);
+    assert.strictEqual(res.headers.get("Referrer-Policy"), "no-referrer");
+
+    const body = await res.text();
+    assert.match(
+      body,
+      /<meta http-equiv="refresh" content="2; url=https:\/\/github.com\/a\/b\/c\?x=1">/,
+    );
+    assert.doesNotMatch(body, /<script/);
+  });
+
+  it("should redirect unhandled search types", async () => {
+    const res = await app.request(
+      "http://cgithub.example/actions/deploy-pages/search?q=x&type=code",
+    );
+
+    assert.strictEqual(res.status, 200);
+    assert.match(
+      await res.text(),
+      /https:\/\/github.com\/actions\/deploy-pages\/search\?q=x&amp;type=code/,
+    );
+  });
+
+  it("should redirect raw file requests to raw.githubusercontent.com", async () => {
+    const res = await app.request("http://cgithub.example/actions/deploy-pages/raw/main/README.md");
+
+    assert.strictEqual(res.status, 200);
+    assert.match(
+      await res.text(),
+      /url=https:\/\/raw.githubusercontent.com\/actions\/deploy-pages\/main\/README.md"/,
+    );
+  });
+});
diff --git a/cgithub/src/app.ts b/cgithub/src/app.ts
index 0218918..9a7ee8e 100644
--- a/cgithub/src/app.ts
+++ b/cgithub/src/app.ts
@@ -19,9 +19,22 @@ import {
   RedirectError,
 } from "./scraper.ts";
 
+// Our URLs mirror GitHub's, so the same path there is the page we scraped.
+function githubUrlFor(c: Context) {
+  const { pathname, search } = new URL(c.req.url);
+  return `https://github.com${pathname}${search}`;
+}
+
 export function createApp(eta: Eta) {
   const app = new Hono();
 
+  // Use a meta refresh to avoid redirect loops in certain situations; we become
+  // the initiator origin even if we are the target of a redirection.
+  function redirectToGitHub(c: Context, location: string) {
+    c.header("Referrer-Policy", "no-referrer");
+    return c.html(eta.render("redirect.eta", { location }));
+  }
+
   app.get("/", async (c) => {
     return c.html(eta.render("home.eta", {}));
   });
@@ -33,7 +46,7 @@ export function createApp(eta: Eta) {
     } catch (e) {
       if (e instanceof RedirectError) {
         if (e.location.startsWith("https://")) {
-          c.header("Referrer-Policy", "no-referrer");
+          return redirectToGitHub(c, e.location);
         }
         return c.redirect(e.location);
       } else if (e instanceof GitHubHTTPError) {
@@ -45,10 +58,7 @@ export function createApp(eta: Eta) {
         return c.html(eta.render("error.eta", { message: "" + e }));
       }
     }
-    // Our URLs mirror GitHub's, so the page we scraped is the same path there.
-    const { pathname, search } = new URL(c.req.url);
-    const githubUrl = `https://github.com${pathname}${search}`;
-    return c.html(eta.render(template, { ...data, githubUrl, commit }));
+    return c.html(eta.render(template, { ...data, githubUrl: githubUrlFor(c), commit }));
   }
 
   // For fragments fetched asynchronously by client-side JS (see public/static/refs.js):
@@ -96,8 +106,10 @@ export function createApp(eta: Eta) {
 
   app.get("/:owner/:repo/raw/:branch/:path{.*}", async (c) => {
     const { owner, repo, branch, path } = c.req.param();
-    c.header("Referrer-Policy", "no-referrer");
-    return c.redirect(`https://raw.githubusercontent.com/${owner}/${repo}/${branch}/${path}`);
+    return redirectToGitHub(
+      c,
+      `https://raw.githubusercontent.com/${owner}/${repo}/${branch}/${path}`,
+    );
   });
 
   app.get("/:owner/:repo/issues", async (c) => {
@@ -131,10 +143,7 @@ export function createApp(eta: Eta) {
     }
 
     // Redirect unhandled search types (like code, which requires sign in anyway).
-    c.header("Referrer-Policy", "no-referrer");
-    return c.redirect(
-      `https://github.com/${owner}/${repo}/search?${new URLSearchParams(c.req.query()).toString()}`,
-    );
+    return redirectToGitHub(c, githubUrlFor(c));
   });
 
   app.get("/:owner/:repo/commits/:branch/:path{.*}?", async (c) => {
@@ -179,9 +188,7 @@ export function createApp(eta: Eta) {
   });
 
   app.all("*", async (c) => {
-    const path = c.req.path;
-    c.header("Referrer-Policy", "no-referrer");
-    return c.redirect(`https://github.com${path}`);
+    return redirectToGitHub(c, githubUrlFor(c));
   });
 
   return app;
diff --git a/cgithub/views/redirect.eta b/cgithub/views/redirect.eta
new file mode 100644
index 0000000..393a527
--- /dev/null
+++ b/cgithub/views/redirect.eta
@@ -0,0 +1,14 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="referrer" content="no-referrer">
+  <meta http-equiv="refresh" content="1; url=<%= it.location %>">
+  <title>Redirecting to GitHub</title>
+  <link rel="stylesheet" href="/static/style.css">
+</head>
+<body>
+  <p>cgithub can't render this page. Redirecting to
+  <a href="<%= it.location %>" rel="noreferrer"><%= it.location %></a>…</p>
+</body>
+</html>
-- 
cgit v1.3.1


From 866f99c414cb3d102483ce21c68a0e62b394baaa Mon Sep 17 00:00:00 2001
From: Joe Mou <dev@mou.fo>
Date: Tue, 11 Aug 2026 13:32:44 -0400
Subject: Keep the ref picker on the current view and path

---
 cgithub/public/static/refs.js |  6 +++--
 cgithub/src/app.test.ts       | 52 ++++++++++++++++++++++++++++++++++++++++++-
 cgithub/src/app.ts            | 12 +++++++---
 cgithub/views/_nav.eta        |  4 ++--
 cgithub/views/_refs.eta       |  6 ++++-
 cgithub/views/_tree.eta       |  2 +-
 cgithub/views/blob.eta        |  2 +-
 cgithub/views/commits.eta     |  2 +-
 8 files changed, 74 insertions(+), 12 deletions(-)

(limited to 'cgithub/src/app.ts')

diff --git a/cgithub/public/static/refs.js b/cgithub/public/static/refs.js
index ffff505..f3e07e8 100644
--- a/cgithub/public/static/refs.js
+++ b/cgithub/public/static/refs.js
@@ -7,7 +7,9 @@ document.addEventListener("DOMContentLoaded", () => {
   const dialog = document.querySelector(".ref-selector-menu");
   if (dialog) {
     const list = dialog.querySelector(".ref-selector-list");
-    const { owner, repo } = dialog.dataset;
+    // The view and path let the picker link to the same place on another ref
+    // rather than to the repository root.
+    const { owner, repo, view, path = "" } = dialog.dataset;
     const cache = {};
 
     async function load(type) {
@@ -17,7 +19,7 @@ document.addEventListener("DOMContentLoaded", () => {
       }
       list.textContent = "Loading…";
       try {
-        const res = await fetch(`/api/${owner}/${repo}/refs/${type}`);
+        const res = await fetch(`/api/${owner}/${repo}/refs/${type}/${view}/${path}`);
         const html = res.ok ? await res.text() : "";
         cache[type] = html || "Failed to load.";
         list.innerHTML = cache[type];
diff --git a/cgithub/src/app.test.ts b/cgithub/src/app.test.ts
index 498d8a6..6544f03 100644
--- a/cgithub/src/app.test.ts
+++ b/cgithub/src/app.test.ts
@@ -8,6 +8,56 @@ import { createApp } from "./app.ts";
 const eta = new Eta({ views: path.join(import.meta.dirname, "..", "views") });
 const app = createApp(eta);
 
+describe("branch picker", () => {
+  const repo = { owner: "actions", name: "deploy-pages" };
+  const refs = [{ name: "main", isDefault: true }, { name: "v4" }];
+
+  it("should keep the current view and path", () => {
+    const blob = eta.render("_refs.eta", {
+      repo,
+      refs,
+      type: "branches",
+      view: "blob",
+      path: "src/main.ts",
+    });
+    const tree = eta.render("_refs.eta", {
+      repo,
+      refs,
+      type: "branches",
+      view: "tree",
+      path: "src",
+    });
+
+    assert.match(blob, /href="\/actions\/deploy-pages\/blob\/main\/src\/main.ts"/);
+    assert.match(blob, /href="\/actions\/deploy-pages\/blob\/v4\/src\/main.ts"/);
+    assert.match(tree, /href="\/actions\/deploy-pages\/tree\/v4\/src"/);
+  });
+
+  it("should link to the root tree without a path", () => {
+    const html = eta.render("_refs.eta", { repo, refs, type: "branches", view: "tree", path: "" });
+
+    assert.match(html, /href="\/actions\/deploy-pages\/tree\/main"/);
+  });
+
+  it("should not build ref links for views it does not serve", async () => {
+    const res = await app.request("http://cgithub.example/api/a/b/refs/branches/raw/README.md");
+
+    assert.strictEqual(res.status, 404);
+  });
+
+  it("should tell the refs endpoint where the picker was opened", () => {
+    const nav = { repo, branch: "main", path: "src" };
+
+    const blob = eta.render("_nav.eta", { ...nav, view: "blob", path: "src/main.ts" });
+    assert.match(blob, /data-view="blob" data-path="src\/main.ts"/);
+    assert.match(
+      eta.render("_nav.eta", { ...nav, view: "tree" }),
+      /data-view="tree" data-path="src"/,
+    );
+    assert.doesNotMatch(eta.render("_nav.eta", { ...nav, view: "tree", path: "" }), /data-path=/);
+  });
+});
+
 describe("redirects to GitHub", () => {
   // An HTTP redirect would be caught by the extension's declarativeNetRequest
   // rules and bounced straight back here.
@@ -21,7 +71,7 @@ describe("redirects to GitHub", () => {
     const body = await res.text();
     assert.match(
       body,
-      /<meta http-equiv="refresh" content="2; url=https:\/\/github.com\/a\/b\/c\?x=1">/,
+      /<meta http-equiv="refresh" content="1; url=https:\/\/github.com\/a\/b\/c\?x=1">/,
     );
     assert.doesNotMatch(body, /<script/);
   });
diff --git a/cgithub/src/app.ts b/cgithub/src/app.ts
index 9a7ee8e..81e47fd 100644
--- a/cgithub/src/app.ts
+++ b/cgithub/src/app.ts
@@ -155,12 +155,18 @@ export function createApp(eta: Eta) {
   // be visited directly. Keep the site's initial page loads plain server-
   // rendered HTML while still surfacing data (branches/tags, latest commit)
   // that would otherwise require an extra scrape on every page view.
-  app.get("/api/:owner/:repo/refs/:type", async (c) => {
-    const { owner, repo, type } = c.req.param();
+  // The view and path are where the picker was opened, so each ref can link to
+  // the same page on another ref.
+  app.get("/api/:owner/:repo/refs/:type/:view/:path{.*}?", async (c) => {
+    const { owner, repo, type, view, path = "" } = c.req.param();
     if (type !== "branches" && type !== "tags") {
       return c.notFound();
     }
-    return tryRenderFragment(c, "_refs.eta", getGitHubRefs(owner, repo, type));
+    if (view !== "tree" && view !== "blob" && view !== "commits") {
+      return c.notFound();
+    }
+    const refs = getGitHubRefs(owner, repo, type).then((data) => ({ ...data, view, path }));
+    return tryRenderFragment(c, "_refs.eta", refs);
   });
 
   app.get("/api/:owner/:repo/latest-commit/:branch/:path{.*}?", async (c) => {
diff --git a/cgithub/views/_nav.eta b/cgithub/views/_nav.eta
index eb7ed42..a20fbbc 100644
--- a/cgithub/views/_nav.eta
+++ b/cgithub/views/_nav.eta
@@ -6,7 +6,7 @@
   <button type="button" class="ref-selector-button branch" command="show-modal" commandfor="ref-selector-menu">
     <img src="/static/icons/git-branch.svg" alt="branch" class="icon"> <%= refLabel %> ▾
   </button>
-  <dialog class="ref-selector-menu" id="ref-selector-menu" closedby="any" data-owner="<%= it.repo.owner %>" data-repo="<%= it.repo.name %>">
+  <dialog class="ref-selector-menu" id="ref-selector-menu" closedby="any" data-owner="<%= it.repo.owner %>" data-repo="<%= it.repo.name %>" data-view="<%= it.view %>"<% if (it.path && it.path !== "/") { %> data-path="<%= it.path %>"<% } %>>
     <div class="ref-selector-tabs">
       <button type="button" class="active" data-ref-type="branches">Branches</button>
       <button type="button" data-ref-type="tags">Tags</button>
@@ -22,7 +22,7 @@
       currentPath += (currentPath ? '/' : '') + part;
       const isLast = i === pathParts.length - 1;
       if (isLast) {
-        %>/<%= part %><%= it.isTree ? "/" : "" %><%
+        %>/<%= part %><%= it.view === "tree" ? "/" : "" %><%
       } else {
         %>/<a href="/<%= it.repo.owner %>/<%= it.repo.name %>/tree/<%= it.branch %>/<%= currentPath %>"><%= part %></a><%
       }
diff --git a/cgithub/views/_refs.eta b/cgithub/views/_refs.eta
index 2450c4b..9d951cc 100644
--- a/cgithub/views/_refs.eta
+++ b/cgithub/views/_refs.eta
@@ -1,10 +1,14 @@
+<%
+const linkPrefix = `/${it.repo.owner}/${it.repo.name}/${it.view}/`;
+const linkSuffix = it.path ? `/${it.path}` : "";
+%>
 <% if (it.refs.length === 0) { %>
   <div class="ref-selector-empty">No <%= it.type %> found.</div>
 <% } else { %>
   <ul class="ref-selector-items">
     <% for (const ref of it.refs) { %>
       <li>
-        <a href="/<%= it.repo.owner %>/<%= it.repo.name %>/tree/<%= ref.name %>"><%= ref.name %></a>
+        <a href="<%= linkPrefix %><%= ref.name %><%= linkSuffix %>"><%= ref.name %></a>
         <% if (ref.isDefault) { %><span class="ref-selector-badge">default</span><% } %>
       </li>
     <% } %>
diff --git a/cgithub/views/_tree.eta b/cgithub/views/_tree.eta
index fc7707b..a3c943d 100644
--- a/cgithub/views/_tree.eta
+++ b/cgithub/views/_tree.eta
@@ -1,4 +1,4 @@
-<%~ include("./_nav.eta", {...it, isTree: true}) %>
+<%~ include("./_nav.eta", {...it, view: "tree"}) %>
 
 <% const commitPath = it.path && it.path !== "/" ? it.path : ""; %>
 <div class="placeholder commit box" data-src="/api/<%= it.repo.owner %>/<%= it.repo.name %>/latest-commit/<%= it.branch %>/<%= commitPath %>">
diff --git a/cgithub/views/blob.eta b/cgithub/views/blob.eta
index 50f92a9..ed1e84b 100644
--- a/cgithub/views/blob.eta
+++ b/cgithub/views/blob.eta
@@ -1,6 +1,6 @@
 <% layout("./layout.eta"); it.searchType = "code" %>
 
-<%~ include("./_nav.eta", it) %>
+<%~ include("./_nav.eta", {...it, view: "blob"}) %>
 
 <div>
   <% if (it.language) { %>
diff --git a/cgithub/views/commits.eta b/cgithub/views/commits.eta
index 2ddcba3..5cf0beb 100644
--- a/cgithub/views/commits.eta
+++ b/cgithub/views/commits.eta
@@ -1,6 +1,6 @@
 <% layout("./layout.eta") %>
 
-<%~ include("./_nav.eta", {...it, isTree: false}) %>
+<%~ include("./_nav.eta", {...it, view: "commits"}) %>
 
 <% for (const group of it.commitGroups) { %>
   <h3><%= group.title %></h3>
-- 
cgit v1.3.1


From 21310d0366c0f21e73c1f4f78d38370edfb59445 Mon Sep 17 00:00:00 2001
From: Joe Mou <dev@mou.fo>
Date: Tue, 11 Aug 2026 17:41:01 -0400
Subject: Read the About box and latest release from JSON

GitHub rebuilt the repository sidebar, so the selectors parseRepoInfo used
matched nothing and the About box rendered empty. Everything but the latest
release is in the page's embedded payload as sidebarAbout; the latest release
is only in the _sidebar JSON already fetched for languages, so it arrives with
that fragment and is moved beside the release count.
---
 cgithub/public/static/refs.js |  10 ++++
 cgithub/src/app.test.ts       |  34 ++++++++++++
 cgithub/src/app.ts            |   6 +-
 cgithub/src/scraper.test.ts   |  15 ++---
 cgithub/src/scraper.ts        | 126 ++++++++++++++----------------------------
 cgithub/views/_languages.eta  |  17 ------
 cgithub/views/_sidebar.eta    |  22 ++++++++
 cgithub/views/repo.eta        |  10 +---
 8 files changed, 122 insertions(+), 118 deletions(-)
 delete mode 100644 cgithub/views/_languages.eta
 create mode 100644 cgithub/views/_sidebar.eta

(limited to 'cgithub/src/app.ts')

diff --git a/cgithub/public/static/refs.js b/cgithub/public/static/refs.js
index f3e07e8..1035593 100644
--- a/cgithub/public/static/refs.js
+++ b/cgithub/public/static/refs.js
@@ -52,10 +52,20 @@ document.addEventListener("DOMContentLoaded", () => {
       .then((html) => {
         if (html.trim()) {
           placeholder.outerHTML = html;
+          relocate();
         } else {
           placeholder.remove();
         }
       })
       .catch(() => placeholder.remove());
   }
+
+  // A fragment may carry a node that belongs elsewhere on the page, where an
+  // empty element of that id holds its spot: the sidebar's latest release
+  // reads as part of the release count, far from the languages it arrives with.
+  function relocate() {
+    for (const node of document.querySelectorAll("[data-target]")) {
+      document.getElementById(node.dataset.target)?.replaceWith(node);
+    }
+  }
 });
diff --git a/cgithub/src/app.test.ts b/cgithub/src/app.test.ts
index 6544f03..5474f8d 100644
--- a/cgithub/src/app.test.ts
+++ b/cgithub/src/app.test.ts
@@ -58,6 +58,40 @@ describe("branch picker", () => {
   });
 });
 
+describe("sidebar fragment", () => {
+  const repo = { owner: "actions", name: "deploy-pages" };
+  const languages = [{ name: "JavaScript", percentage: 100, color: "#f1e05a" }];
+  const latestRelease = { tag: "v5.0.0", publishedAt: "2026-03-25T16:59:14Z" };
+
+  // The release replaces the empty element it names, beside the release count.
+  it("should render the latest release and the languages", () => {
+    const html = eta.render("_sidebar.eta", { repo, languages, latestRelease });
+
+    assert.match(html, /<span data-target="latest-release">\(<a href/);
+    assert.match(html, /href="\/actions\/deploy-pages\/releases\/tag\/v5.0.0"/);
+    assert.match(html, /<time class="timestamp" title="2026-03-25T16:59:14Z">2026-03-25<\/time>/);
+    assert.match(html, /<div class="languages box">/);
+  });
+
+  it("should name a spot the repo page holds open", () => {
+    const html = eta.render("repo.eta", {
+      repo,
+      branch: "main",
+      path: "/",
+      items: [],
+      info: { description: null, website: null, stars: null, forks: null, numReleases: 38 },
+    });
+
+    assert.match(html, /<span id="latest-release"><\/span>/);
+  });
+
+  it("should render nothing when the repository has neither", () => {
+    const html = eta.render("_sidebar.eta", { repo, languages: [], latestRelease: null });
+
+    assert.strictEqual(html.trim(), "");
+  });
+});
+
 describe("redirects to GitHub", () => {
   // An HTTP redirect would be caught by the extension's declarativeNetRequest
   // rules and bounced straight back here.
diff --git a/cgithub/src/app.ts b/cgithub/src/app.ts
index 81e47fd..e27db59 100644
--- a/cgithub/src/app.ts
+++ b/cgithub/src/app.ts
@@ -6,7 +6,7 @@ import {
   getGitHubBlob,
   getGitHubCommits,
   getGitHubIssues,
-  getGitHubLanguages,
+  getGitHubSidebar,
   getGitHubLatestCommit,
   getGitHubOwner,
   getGitHubPulls,
@@ -178,9 +178,9 @@ export function createApp(eta: Eta) {
     );
   });
 
-  app.get("/api/:owner/:repo/languages", async (c) => {
+  app.get("/api/:owner/:repo/sidebar", async (c) => {
     const { owner, repo } = c.req.param();
-    return tryRenderFragment(c, "_languages.eta", getGitHubLanguages(owner, repo));
+    return tryRenderFragment(c, "_sidebar.eta", getGitHubSidebar(owner, repo));
   });
 
   app.get("/:owner/:repo/releases/tag/:tag", async (c) => {
diff --git a/cgithub/src/scraper.test.ts b/cgithub/src/scraper.test.ts
index 5b5e78b..24fdfc0 100644
--- a/cgithub/src/scraper.test.ts
+++ b/cgithub/src/scraper.test.ts
@@ -4,7 +4,7 @@ import {
   getGitHubBlob,
   getGitHubCommits,
   getGitHubIssues,
-  getGitHubLanguages,
+  getGitHubSidebar,
   getGitHubLatestCommit,
   getGitHubPulls,
   getGitHubRefs,
@@ -35,8 +35,6 @@ describe("GitHub scraper", () => {
       assert.strictEqual(data.info.stars?.length, 3);
       assert.strictEqual(data.info.forks?.length, 3);
       assert.strictEqual(data.info.numReleases, 38);
-      assert.strictEqual(data.info.latestReleaseTag, "v5.0.0");
-      assert.ok(data.info.latestReleaseDate?.startsWith("2026-03-25"));
 
       assert.ok(data.items.length > 0);
       assert.ok(typeof data.overviewHtml?.["README.md"] === "string");
@@ -220,8 +218,8 @@ describe("GitHub scraper", () => {
       assert.ok(data.commit.authors.length > 0);
     });
 
-    it("should fetch languages", async () => {
-      const data = await getGitHubLanguages("actions", "deploy-pages");
+    it("should fetch the sidebar", async () => {
+      const data = await getGitHubSidebar("actions", "deploy-pages");
 
       assert.strictEqual(data.repo.owner, "actions");
       assert.strictEqual(data.repo.name, "deploy-pages");
@@ -229,10 +227,13 @@ describe("GitHub scraper", () => {
       assert.deepStrictEqual(data.languages, [
         { name: "JavaScript", percentage: 100, color: "#f1e05a" },
       ]);
+
+      assert.strictEqual(data.latestRelease?.tag, "v5.0.0");
+      assert.ok(data.latestRelease?.publishedAt?.startsWith("2026-03-25"));
     });
 
-    it("should fetch languages for a multi-language repository", async () => {
-      const data = await getGitHubLanguages("rust-lang", "rust");
+    it("should fetch the sidebar for a multi-language repository", async () => {
+      const data = await getGitHubSidebar("rust-lang", "rust");
 
       const rust = data.languages.find((language) => language.name === "Rust");
       assert.ok(rust);
diff --git a/cgithub/src/scraper.ts b/cgithub/src/scraper.ts
index 223839f..4220dc4 100644
--- a/cgithub/src/scraper.ts
+++ b/cgithub/src/scraper.ts
@@ -143,7 +143,17 @@ interface CodeViewBlobRoute {
   richText: string | null;
 }
 
+interface SidebarAbout {
+  description?: string | null;
+  website?: string | null;
+  stargazerCount?: number;
+  forksCount?: number;
+  // A section is false when the repository has none of that thing.
+  sections?: { releases?: { releaseCount?: number } | false };
+}
+
 interface AppPayload {
+  sidebarAbout?: SidebarAbout;
   codeViewLayoutRoute?: CodeViewLayoutRoute;
   codeViewRepoRoute?: CodeViewRepoRoute;
   codeViewTreeRoute?: CodeViewTreeRoute;
@@ -230,8 +240,6 @@ export interface RepoInfo {
   stars: string | null;
   forks: string | null;
   numReleases?: number;
-  latestReleaseTag?: string;
-  latestReleaseDate?: string;
 }
 
 export interface GitHubRepo extends GitHubTree {
@@ -292,8 +300,14 @@ export interface Language {
   color: string | null;
 }
 
-export interface GitHubLanguages extends GitHubCommon {
+export interface LatestRelease {
+  tag: string;
+  publishedAt: string | null;
+}
+
+export interface GitHubSidebar extends GitHubCommon {
   languages: Language[];
+  latestRelease: LatestRelease | null;
 }
 
 export interface Ref {
@@ -425,81 +439,6 @@ function parsePayload(html: string): AppPayload | null {
   return parseEmbeddedPayload<AppPayload>(html);
 }
 
-function parseRepoInfo(html: string): RepoInfo {
-  const document = parseDocument(html);
-
-  const aboutSection = cssSelect.selectOne(".BorderGrid-cell h2:contains('About')", document);
-  let description: string | null = null;
-  let website: string | null = null;
-
-  if (aboutSection) {
-    const parent = aboutSection.parent;
-    if (parent) {
-      const descElem = cssSelect.selectOne("p.f4", parent);
-      if (descElem) {
-        description = textContent(descElem).trim();
-      }
-      const websiteElem = cssSelect.selectOne(
-        "a[rel='noopener noreferrer nofollow']",
-        parent,
-      ) as Element | null;
-      if (websiteElem) {
-        website = getAttributeValue(websiteElem, "href") || null;
-      }
-    }
-  }
-
-  const starsElem = cssSelect.selectOne("#repo-stars-counter-star", document) as Element | null;
-  const stars = starsElem
-    ? getAttributeValue(starsElem, "title") || textContent(starsElem).trim()
-    : null;
-
-  const forksElem = cssSelect.selectOne("#repo-network-counter", document) as Element | null;
-  const forks = forksElem
-    ? getAttributeValue(forksElem, "title") || textContent(forksElem).trim()
-    : null;
-
-  const releaseElem = cssSelect.selectOne(
-    "a[href$='/releases'] .Counter",
-    document,
-  ) as Element | null;
-  let numReleases: number | undefined;
-  let latestReleaseTag: string | undefined;
-  let latestReleaseDate: string | undefined;
-
-  if (releaseElem) {
-    const releaseText = getAttributeValue(releaseElem, "title") || textContent(releaseElem);
-    numReleases = parseInt(releaseText.replace(/,/g, ""), 10);
-
-    // Find the latest release tag and date if available
-    const cell = (releaseElem.parent as Element)?.parent?.parent as Element; // span -> a -> h2 -> cell
-    if (cell) {
-      const latestLink = cssSelect.selectOne("a[href*='/releases/tag/']", cell) as Element;
-      if (latestLink) {
-        const tagElem = cssSelect.selectOne(".css-truncate-target", latestLink);
-        if (tagElem) {
-          latestReleaseTag = textContent(tagElem).trim();
-        }
-
-        const timeElem = cssSelect.selectOne("relative-time", latestLink);
-        if (timeElem) {
-          latestReleaseDate = getAttributeValue(timeElem, "datetime") || undefined;
-        }
-      }
-    }
-  }
-
-  return {
-    description,
-    website,
-    stars,
-    forks,
-    numReleases,
-    latestReleaseTag,
-    latestReleaseDate,
-  };
-}
-
 function extractOverviewHtml(
   overviewFiles: OverviewFile[] = [],
 ): Record<string, string | null> | undefined {
@@ -539,7 +478,15 @@ export async function getGitHubRepo(owner: string, repo: string): Promise<GitHub
     throw new Error("Could not find tree data in embedded JSON");
   }
 
-  const info = parseRepoInfo(html);
+  const about = payload?.sidebarAbout;
+  const releases = about?.sections?.releases;
+  const info = {
+    description: about?.description ?? null,
+    website: about?.website ?? null,
+    stars: about?.stargazerCount?.toLocaleString("en-US") ?? null,
+    forks: about?.forksCount?.toLocaleString("en-US") ?? null,
+    numReleases: releases === false ? undefined : releases?.releaseCount,
+  };
   const overviewHtml = extractOverviewHtml(repoRoute.overview?.overviewFiles);
 
   return extractGitHub(payload, { items: repoRoute.tree.items, info, overviewHtml });
@@ -742,11 +689,16 @@ interface SidebarPayload {
       color?: string;
     }[];
   };
+  releases?: {
+    // The name is the release title, which need not be the tag; the path is.
+    latestRelease?: { name?: string; path: string; publishedAt?: string } | null;
+  };
 }
 
-// The repository sidebar (languages, contributors, ...) is not rendered into
-// the repo page at all; GitHub's own UI lazily fetches it as JSON from here.
-export async function getGitHubLanguages(owner: string, repo: string): Promise<GitHubLanguages> {
+// The repository sidebar (languages, releases, contributors, ...) is not
+// rendered into the repo page at all; GitHub's own UI lazily fetches it as
+// JSON from here.
+export async function getGitHubSidebar(owner: string, repo: string): Promise<GitHubSidebar> {
   const payload = await fetchGitHubJson<SidebarPayload>(`${owner}/${repo}/_sidebar`);
 
   const languages: Language[] = [];
@@ -758,7 +710,15 @@ export async function getGitHubLanguages(owner: string, repo: string): Promise<G
     });
   }
 
-  return { repo: { owner, name: repo }, languages };
+  const release = payload.releases?.latestRelease;
+  const latestRelease = release
+    ? {
+        tag: decodeURIComponent(release.path.split("/releases/tag/")[1] ?? release.name ?? ""),
+        publishedAt: release.publishedAt ?? null,
+      }
+    : null;
+
+  return { repo: { owner, name: repo }, languages, latestRelease };
 }
 
 interface BranchRefEntry {
diff --git a/cgithub/views/_languages.eta b/cgithub/views/_languages.eta
deleted file mode 100644
index 8aca447..0000000
--- a/cgithub/views/_languages.eta
+++ /dev/null
@@ -1,17 +0,0 @@
-<% if (it.languages.length > 0) { %>
-  <div class="languages box">
-    <div class="language-bar">
-      <% for (const lang of it.languages) { %>
-        <span style="width: <%= lang.percentage %>%; background: <%= lang.color ?? "#ededed" %>" title="<%= lang.name %> <%= lang.percentage %>%"></span>
-      <% } %>
-    </div>
-    <ul class="language-list">
-      <% for (const lang of it.languages) { %>
-        <li>
-          <span class="language-dot" style="background: <%= lang.color ?? "#ededed" %>"></span>
-          <%= lang.name %> <span class="language-percentage"><%= lang.percentage %>%</span>
-        </li>
-      <% } %>
-    </ul>
-  </div>
-<% } %>
diff --git a/cgithub/views/_sidebar.eta b/cgithub/views/_sidebar.eta
new file mode 100644
index 0000000..bceef7c
--- /dev/null
+++ b/cgithub/views/_sidebar.eta
@@ -0,0 +1,22 @@
+<% if (it.latestRelease) { %>
+  <span data-target="latest-release">(<a href="/<%= it.repo.owner %>/<%= it.repo.name %>/releases/tag/<%= it.latestRelease.tag %>"><%= it.latestRelease.tag %></a><%
+    if (it.latestRelease.publishedAt) { %> <time class="timestamp" title="<%= it.latestRelease.publishedAt %>"><%= it.latestRelease.publishedAt.split("T")[0] %></time><%
+    } %>)</span>
+<% } %>
+<% if (it.languages.length > 0) { %>
+  <div class="languages box">
+    <div class="language-bar">
+      <% for (const lang of it.languages) { %>
+        <span style="width: <%= lang.percentage %>%; background: <%= lang.color ?? "#ededed" %>" title="<%= lang.name %> <%= lang.percentage %>%"></span>
+      <% } %>
+    </div>
+    <ul class="language-list">
+      <% for (const lang of it.languages) { %>
+        <li>
+          <span class="language-dot" style="background: <%= lang.color ?? "#ededed" %>"></span>
+          <%= lang.name %> <span class="language-percentage"><%= lang.percentage %>%</span>
+        </li>
+      <% } %>
+    </ul>
+  </div>
+<% } %>
diff --git a/cgithub/views/repo.eta b/cgithub/views/repo.eta
index 1bff97f..5dc6beb 100644
--- a/cgithub/views/repo.eta
+++ b/cgithub/views/repo.eta
@@ -17,19 +17,13 @@
     <% if (it.info.numReleases) { %>
       <div class="detail">
         <a href="/<%= it.repo.owner %>/<%= it.repo.name %>/releases"><%= it.info.numReleases %> releases</a>
-        <% if (it.info.latestReleaseTag) { %>
-          (<a href="/<%= it.repo.owner %>/<%= it.repo.name %>/releases/tag/<%= it.info.latestReleaseTag %>"><%= it.info.latestReleaseTag %></a>
-          <% if (it.info.latestReleaseDate) { %>
-            <time class="timestamp" title="<%= it.info.latestReleaseDate %>"><%= it.info.latestReleaseDate.split("T")[0] %></time>
-          <% } %>
-          )
-        <% } %>
+        <span id="latest-release"></span>
       </div>
     <% } %>
   </div>
 <% } %>
 
-<div class="placeholder languages box" data-src="/api/<%= it.repo.owner %>/<%= it.repo.name %>/languages">
+<div class="placeholder languages box" data-src="/api/<%= it.repo.owner %>/<%= it.repo.name %>/sidebar">
     <div class="language-bar"><span style="width: 100%; background: #ededed"></span></div>
     <ul class="language-list"><li>…</li></ul>
 </div>
-- 
cgit v1.3.1


From 679a2b71c3e73dc1b8cf11806b3f3df49018b535 Mon Sep 17 00:00:00 2001
From: Joe Mou <dev@mou.fo>
Date: Wed, 12 Aug 2026 01:27:25 -0400
Subject: Use an HTTP redirect for same-origin requests

The meta refresh page renders as a broken image when the request came
from an <img> on one of our own pages. Such requests are already past
the redirect-loop hazard the refresh works around, so send them a real
redirect instead.
---
 cgithub/src/app.test.ts | 20 ++++++++++++++++++++
 cgithub/src/app.ts      | 10 +++++++++-
 2 files changed, 29 insertions(+), 1 deletion(-)

(limited to 'cgithub/src/app.ts')

diff --git a/cgithub/src/app.test.ts b/cgithub/src/app.test.ts
index 5474f8d..59ed352 100644
--- a/cgithub/src/app.test.ts
+++ b/cgithub/src/app.test.ts
@@ -110,6 +110,26 @@ describe("redirects to GitHub", () => {
     assert.doesNotMatch(body, /<script/);
   });
 
+  // Same-origin requests are mostly subresources, which render an HTML page as
+  // a broken image rather than following its refresh.
+  it("should redirect over HTTP when the referer is one of our own pages", async () => {
+    const res = await app.request("http://cgithub.example/a/b/c?x=1", {
+      headers: { Referer: "http://cgithub.example/a/b" },
+    });
+
+    assert.strictEqual(res.status, 302);
+    assert.strictEqual(res.headers.get("location"), "https://github.com/a/b/c?x=1");
+  });
+
+  it("should use a meta refresh when the referer is another site", async () => {
+    const res = await app.request("http://cgithub.example/a/b/c?x=1", {
+      headers: { Referer: "https://github.example/a/b" },
+    });
+
+    assert.strictEqual(res.status, 200);
+    assert.strictEqual(res.headers.get("location"), null);
+  });
+
   it("should redirect unhandled search types", async () => {
     const res = await app.request(
       "http://cgithub.example/actions/deploy-pages/search?q=x&type=code",
diff --git a/cgithub/src/app.ts b/cgithub/src/app.ts
index e27db59..9781a98 100644
--- a/cgithub/src/app.ts
+++ b/cgithub/src/app.ts
@@ -29,8 +29,16 @@ export function createApp(eta: Eta) {
   const app = new Hono();
 
   // Use a meta refresh to avoid redirect loops in certain situations; we become
-  // the initiator origin even if we are the target of a redirection.
+  // the initiator origin even if we are the target of a redirection. Requests
+  // coming from one of our own pages are already past that hazard, and are
+  // often subresources (an <img> in a rendered README) that can't do anything
+  // with an HTML page, so those get a real HTTP redirect.
   function redirectToGitHub(c: Context, location: string) {
+    const referer = c.req.header("Referer");
+    if (referer && URL.parse(referer)?.origin === new URL(c.req.url).origin) {
+      return c.redirect(location);
+    }
+
     c.header("Referrer-Policy", "no-referrer");
     return c.html(eta.render("redirect.eta", { location }));
   }
-- 
cgit v1.3.1


From 0d60b8c8235c3c07f675aba7a56dd37b62519f9e Mon Sep 17 00:00:00 2001
From: Joe Mou <dev@mou.fo>
Date: Thu, 27 Aug 2026 14:08:06 -0400
Subject: Display PDF blobs

GitHub renders a PDF with a viewer of its own and so ships no content for
one, leaving the blob view with nothing to show. Its raw bytes come as
application/octet-stream, which browsers download rather than display, so
serve them from a new embed route that retypes them and point an <object>
at that.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BErPR92xppzGFXkPqXPYj2
---
 cgithub/public/static/style.css |  7 +++++
 cgithub/src/app.test.ts         | 68 +++++++++++++++++++++++++++++++++++++++--
 cgithub/src/app.ts              | 26 ++++++++++++++++
 cgithub/src/scraper.test.ts     | 32 +++++++++++++++++++
 cgithub/src/scraper.ts          | 28 ++++++++++++++---
 cgithub/views/blob.eta          |  7 ++++-
 6 files changed, 161 insertions(+), 7 deletions(-)

(limited to 'cgithub/src/app.ts')

diff --git a/cgithub/public/static/style.css b/cgithub/public/static/style.css
index ed64bc6..157cc15 100644
--- a/cgithub/public/static/style.css
+++ b/cgithub/public/static/style.css
@@ -276,6 +276,13 @@ body > footer {
   }
 }
 
+object.pdf {
+  display: block;
+  width: 100%;
+  height: 80vh;
+  padding: 0;
+}
+
 pre.box {
   /* Instead of scrolling overflow for long lines, grow the box. */
   width: fit-content;
diff --git a/cgithub/src/app.test.ts b/cgithub/src/app.test.ts
index 94bf205..e28c375 100644
--- a/cgithub/src/app.test.ts
+++ b/cgithub/src/app.test.ts
@@ -1,6 +1,6 @@
 import assert from "node:assert";
 import path from "node:path";
-import { describe, it } from "node:test";
+import { describe, it, type TestContext } from "node:test";
 import { Eta } from "eta";
 import { createApp } from "./app.ts";
 
@@ -100,12 +100,30 @@ describe("blob view", () => {
     language: null,
     size: "815 KB",
     image: false,
+    renderFileType: null,
     textLines: null,
     htmlLines: null,
     htmlContent: null,
   };
 
-  // GitHub previews neither the text nor the bytes of most binary files.
+  it("should embed a PDF", () => {
+    const html = eta.render("blob.eta", {
+      ...blob,
+      path: "test/pdfs/basicapi.pdf",
+      renderFileType: "pdf",
+    });
+
+    assert.match(html, /<object[^>]*type="application\/pdf"/);
+    assert.match(html, /data="\/justrajdeep\/fonts\/embed\/pdf\/master\/test\/pdfs\/basicapi.pdf"/);
+  });
+
+  it("should not embed a file type it has no viewer for", () => {
+    const html = eta.render("blob.eta", { ...blob, renderFileType: "stl" });
+
+    assert.doesNotMatch(html, /<object/);
+    assert.match(html, /This file cannot be displayed\./);
+  });
+
   it("should offer the raw file when there is nothing to display", () => {
     const html = eta.render("blob.eta", blob);
 
@@ -114,6 +132,52 @@ describe("blob view", () => {
   });
 });
 
+describe("embedded files", () => {
+  function stubGitHub(t: TestContext, body: string, contentType: string, status = 200) {
+    t.mock.method(
+      globalThis,
+      "fetch",
+      async () => new Response(body, { status, headers: { "Content-Type": contentType } }),
+    );
+  }
+
+  it("should retype a PDF GitHub sends as a download", async (t) => {
+    stubGitHub(t, "%PDF-1.6", "application/octet-stream");
+
+    const res = await app.request("http://cgithub.example/mozilla/pdf.js/embed/pdf/master/doc.pdf");
+
+    assert.strictEqual(res.status, 200);
+    assert.strictEqual(res.headers.get("Content-Type"), "application/pdf");
+    assert.strictEqual(await res.text(), "%PDF-1.6");
+  });
+
+  it("should pass on a type GitHub already got right", async (t) => {
+    stubGitHub(t, "%PDF-1.6", "application/pdf");
+
+    const res = await app.request("http://cgithub.example/mozilla/pdf.js/embed/pdf/master/doc.pdf");
+
+    assert.strictEqual(res.headers.get("Content-Type"), "application/pdf");
+  });
+
+  it("should not serve a file type it has no viewer for", async (t) => {
+    stubGitHub(t, "<script>", "text/html");
+
+    const res = await app.request("http://cgithub.example/mozilla/pdf.js/embed/html/master/x.html");
+
+    assert.strictEqual(res.status, 404);
+  });
+
+  it("should pass on the status of a file GitHub does not have", async (t) => {
+    stubGitHub(t, "404: Not Found", "text/plain", 404);
+
+    const res = await app.request(
+      "http://cgithub.example/mozilla/pdf.js/embed/pdf/master/nope.pdf",
+    );
+
+    assert.strictEqual(res.status, 404);
+  });
+});
+
 describe("redirects to GitHub", () => {
   // An HTTP redirect would be caught by the extension's declarativeNetRequest
   // rules and bounced straight back here.
diff --git a/cgithub/src/app.ts b/cgithub/src/app.ts
index 9781a98..33b408e 100644
--- a/cgithub/src/app.ts
+++ b/cgithub/src/app.ts
@@ -10,6 +10,7 @@ import {
   getGitHubLatestCommit,
   getGitHubOwner,
   getGitHubPulls,
+  getGitHubRaw,
   getGitHubRefs,
   getGitHubRelease,
   getGitHubReleases,
@@ -120,6 +121,31 @@ export function createApp(eta: Eta) {
     );
   });
 
+  // This is not a native GitHub route, but instead it lets us render blob
+  // content whose raw headers prevent hotlinking.
+  app.get("/:owner/:repo/embed/:type/:branch/:path{.*}", async (c) => {
+    const { owner, repo, type, branch, path } = c.req.param();
+
+    if (type !== "pdf") {
+      return c.notFound();
+    }
+
+    let response: Response;
+    try {
+      response = await getGitHubRaw(owner, repo, branch, path);
+    } catch (e) {
+      c.status(e instanceof GitHubHTTPError ? (e.status as StatusCode) : 500);
+      return c.body(null);
+    }
+
+    let contentType = response.headers.get("Content-Type");
+    if (contentType === null || contentType === "application/octet-stream") {
+      contentType = "application/pdf";
+    }
+
+    return new Response(response.body, { headers: { "Content-Type": contentType } });
+  });
+
   app.get("/:owner/:repo/issues", async (c) => {
     const { owner, repo } = c.req.param();
     const q = c.req.query("q");
diff --git a/cgithub/src/scraper.test.ts b/cgithub/src/scraper.test.ts
index 836235e..88e9271 100644
--- a/cgithub/src/scraper.test.ts
+++ b/cgithub/src/scraper.test.ts
@@ -7,6 +7,7 @@ import {
   getGitHubSidebar,
   getGitHubLatestCommit,
   getGitHubPulls,
+  getGitHubRaw,
   getGitHubRefs,
   getGitHubRelease,
   getGitHubReleases,
@@ -328,11 +329,41 @@ describe("GitHub scraper", () => {
       assert.strictEqual(data.size, "1.26 KB");
       assert.strictEqual(data.language, null);
       assert.strictEqual(data.image, true);
+      assert.strictEqual(data.renderFileType, null);
       assert.strictEqual(data.textLines, null);
       assert.strictEqual(data.htmlLines, null);
       assert.strictEqual(data.htmlContent, null);
     });
 
+    // GitHub renders a PDF with a viewer of its own, so the page carries no
+    // content for it beyond the file type.
+    it("should support PDF", async () => {
+      const data = await getGitHubBlob("mozilla", "pdf.js", "master", "test/pdfs/basicapi.pdf");
+
+      assert.strictEqual(data.repo.owner, "mozilla");
+      assert.strictEqual(data.repo.name, "pdf.js");
+      assert.strictEqual(data.branch, "master");
+      assert.strictEqual(data.path, "test/pdfs/basicapi.pdf");
+
+      assert.strictEqual(data.size, "103 KB");
+      assert.strictEqual(data.language, null);
+      assert.strictEqual(data.image, false);
+      assert.strictEqual(data.renderFileType, "pdf");
+      assert.strictEqual(data.textLines, null);
+      assert.strictEqual(data.htmlLines, null);
+      assert.strictEqual(data.htmlContent, null);
+    });
+
+    // Why the embed route exists rather than the blob view pointing a viewer
+    // at GitHub: as application/octet-stream a browser downloads the file
+    // instead of displaying it.
+    it("should fetch a raw PDF that GitHub types as a download", async () => {
+      const response = await getGitHubRaw("mozilla", "pdf.js", "master", "test/pdfs/basicapi.pdf");
+
+      assert.strictEqual(response.headers.get("Content-Type"), "application/octet-stream");
+      assert.ok((await response.text()).startsWith("%PDF-"));
+    });
+
     // A binary file GitHub has no preview for: no content of any kind, and the
     // path exercises escaping of a space.
     it("should support an unpreviewable binary file", async () => {
@@ -346,6 +377,7 @@ describe("GitHub scraper", () => {
       assert.strictEqual(data.size, "815 KB");
       assert.strictEqual(data.language, null);
       assert.strictEqual(data.image, false);
+      assert.strictEqual(data.renderFileType, null);
       assert.strictEqual(data.textLines, null);
       assert.strictEqual(data.htmlLines, null);
       assert.strictEqual(data.htmlContent, null);
diff --git a/cgithub/src/scraper.ts b/cgithub/src/scraper.ts
index 4220dc4..1a67d05 100644
--- a/cgithub/src/scraper.ts
+++ b/cgithub/src/scraper.ts
@@ -141,6 +141,7 @@ interface CodeViewBlobLayoutRouteStyledBlob {
 
 interface CodeViewBlobRoute {
   richText: string | null;
+  renderedFileInfo?: { renderFileType: string | null } | null;
 }
 
 interface SidebarAbout {
@@ -250,6 +251,7 @@ export interface GitHubBlob extends GitHubNav {
   language: string | null;
   size: string;
   image: boolean;
+  renderFileType: string | null;
   textLines: string[] | null;
   htmlLines: string[] | null;
   htmlContent: string | null;
@@ -378,15 +380,19 @@ export interface GitHubOwner {
   repos: OwnerRepo[];
 }
 
-async function fetchGitHubResponse(path: string, accept: string): Promise<Response> {
-  // GitHub throttles/blocks requests without realistic browser headers.
-  // These headers make the request appear as a standard browser visit.
-  const headers = {
+// GitHub throttles/blocks requests without realistic browser headers.
+// These headers make the request appear as a standard browser visit.
+function browserHeaders(accept: string): Record<string, string> {
+  return {
     "User-Agent":
       "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36",
     Accept: accept,
     "Accept-Language": "en-US,en;q=0.5",
   };
+}
+
+async function fetchGitHubResponse(path: string, accept: string): Promise<Response> {
+  const headers = browserHeaders(accept);
   const response = await fetch(`https://github.com/${path}`, { headers, redirect: "manual" });
   if (response.status === 301 || response.status === 302) {
     const location = response.headers.get("location");
@@ -546,12 +552,26 @@ export async function getGitHubBlob(
     language: blob.language || null,
     size,
     image: blob.image,
+    renderFileType: payload?.codeViewBlobRoute?.renderedFileInfo?.renderFileType ?? null,
     textLines: styledBlob?.rawLines ?? null,
     htmlLines,
     htmlContent: payload?.codeViewBlobRoute?.richText ?? null,
   });
 }
 
+// For proxying embeds.
+export async function getGitHubRaw(
+  owner: string,
+  repo: string,
+  branch: string,
+  path: string,
+): Promise<Response> {
+  const url = `https://raw.githubusercontent.com/${owner}/${repo}/${branch}/${path}`;
+  const response = await fetch(url, { headers: browserHeaders("*/*") });
+  if (!response.ok) throw new GitHubHTTPError(response.status, response.statusText);
+  return response;
+}
+
 export async function getGitHubIssues(
   owner: string,
   repo: string,
diff --git a/cgithub/views/blob.eta b/cgithub/views/blob.eta
index c7315f6..444508e 100644
--- a/cgithub/views/blob.eta
+++ b/cgithub/views/blob.eta
@@ -14,6 +14,11 @@
 
 <% if (it.image) { %>
   <div class="box"><img src="/<%= it.repo.owner %>/<%= it.repo.name %>/raw/<%= it.branch %>/<%= it.path %>"></div>
+<% } else if (it.renderFileType === "pdf") { %>
+  <object class="box pdf" type="application/pdf"
+          data="/<%= it.repo.owner %>/<%= it.repo.name %>/embed/<%= it.renderFileType %>/<%= it.branch %>/<%= it.path %>">
+    This file cannot be displayed.
+  </object>
 <% } else if (it.htmlContent) { %>
   <div class="box"><%~ it.htmlContent %></div>
 <% } else if (it.htmlLines) { %>
@@ -21,5 +26,5 @@
 <% } else if (it.textLines) { %>
   <pre class="box"><code><%= it.textLines.join("\n") %></code></pre>
 <% } else { %>
-  <div class="box">This file cannot be displayed</div>
+  <div class="box">This file cannot be displayed.</div>
 <% } %>
-- 
cgit v1.3.1


From 4c66a07a995c0d551cd284d6e72826b4f7748bab Mon Sep 17 00:00:00 2001
From: Joe Mou <dev@mou.fo>
Date: Thu, 3 Sep 2026 00:08:06 -0400
Subject: Render repository wikis

Wikis are one of the last parts of GitHub still served as plain Rails
HTML, with no embedded JSON to read, so this scrapes the markup: a page
and any older revision of it, the _Sidebar and _Footer a wiki can
define, and the page index. Every page is already in the sidebar of
every page, since the "Show N more pages" button only unhides the rest,
so linking the whole wiki costs no second request.

Routes mirror GitHub's and resolve in its order, so an underscore name
reserved for its own actions (_pages, _history, _new, _edit) can never
be mistaken for a page; the ones we don't serve fall through to the
usual redirect. A slug reaches us decoded and has to be encoded again
rather than interpolated the way a ref is, or a page named C# would
truncate at the fragment.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013rQG1io1i4GJQW5RFcXNGd
---
 cgithub/CLAUDE.md               |   3 ++
 cgithub/public/static/style.css |  21 +++++++-
 cgithub/src/app.test.ts         |  98 ++++++++++++++++++++++++++++++++++
 cgithub/src/app.ts              |  32 +++++++++++
 cgithub/src/scraper.test.ts     |  80 ++++++++++++++++++++++++++++
 cgithub/src/scraper.ts          | 115 +++++++++++++++++++++++++++++++++++++++-
 cgithub/views/_wikiNav.eta      |   4 ++
 cgithub/views/layout.eta        |   1 +
 cgithub/views/wiki.eta          |  37 +++++++++++++
 cgithub/views/wikiPages.eta     |  16 ++++++
 10 files changed, 404 insertions(+), 3 deletions(-)
 create mode 100644 cgithub/views/_wikiNav.eta
 create mode 100644 cgithub/views/wiki.eta
 create mode 100644 cgithub/views/wikiPages.eta

(limited to 'cgithub/src/app.ts')

diff --git a/cgithub/CLAUDE.md b/cgithub/CLAUDE.md
index 0ef4b47..c0c211d 100644
--- a/cgithub/CLAUDE.md
+++ b/cgithub/CLAUDE.md
@@ -33,6 +33,9 @@ pnpm test
 - `GET /:owner/:repo` - Repository info with directory listing
 - `GET /:owner/:repo/tree/:branch/:path*` - Directory listing
 - `GET /:owner/:repo/blob/:branch/:path` - File content view
+- `GET /:owner/:repo/wiki` - Wiki home page
+- `GET /:owner/:repo/wiki/:page` - Wiki page (also `/:page/:oid` for a revision)
+- `GET /:owner/:repo/wiki/_pages` - Wiki page index
 
 ## Instructions
 
diff --git a/cgithub/public/static/style.css b/cgithub/public/static/style.css
index 157cc15..a83e128 100644
--- a/cgithub/public/static/style.css
+++ b/cgithub/public/static/style.css
@@ -288,7 +288,7 @@ pre.box {
   width: fit-content;
 }
 
-.overview, .release {
+.overview, .release, .wiki {
   overflow-wrap: break-word;
 
   /* This is a bit convoluted: we want the effect of padding but using margins
@@ -332,7 +332,7 @@ pre.box {
   font-weight: bold;
 }
 
-.release > header {
+.release > header, .wiki > header {
   display: flex;
   align-items: baseline;
   > :first-child {
@@ -341,6 +341,23 @@ pre.box {
   }
 }
 
+.wiki > footer {
+  /* The wiki's _Footer page is rendered content, not a caption for the page. */
+  font-size: .9rem;
+}
+
+.wiki-pages {
+  summary {
+    cursor: pointer;
+  }
+
+  ul {
+    columns: 16rem;
+    list-style: none;
+    padding: 0;
+  }
+}
+
 .timestamp {
   white-space: nowrap;
   font-size: .8rem;
diff --git a/cgithub/src/app.test.ts b/cgithub/src/app.test.ts
index e28c375..3ecebd0 100644
--- a/cgithub/src/app.test.ts
+++ b/cgithub/src/app.test.ts
@@ -178,6 +178,104 @@ describe("embedded files", () => {
   });
 });
 
+describe("wiki", () => {
+  const repo = { owner: "ariya", name: "phantomjs" };
+  const page = {
+    repo,
+    title: "Home",
+    updatedBy: "pixiuPL",
+    updatedAt: "2018-02-08T18:57:56Z",
+    bodyHtml: "<p>New to <strong>PhantomJS</strong>?</p>",
+    sidebarHtml: null,
+    footerHtml: null,
+    pages: [
+      { name: "Home", href: "/ariya/phantomjs/wiki" },
+      { name: "API Reference WebPage", href: "/ariya/phantomjs/wiki/API-Reference-WebPage" },
+    ],
+  };
+
+  it("should render the page beside who last edited it", () => {
+    const html = eta.render("wiki.eta", page);
+
+    assert.match(html, /<p>New to <strong>PhantomJS<\/strong>\?<\/p>/);
+    assert.match(html, /pixiuPL edited this page/);
+    assert.match(html, /<time title="2018-02-08T18:57:56Z">2018-02-08<\/time>/);
+  });
+
+  // The _Sidebar and _Footer pages a wiki can define, which GitHub renders
+  // alongside every page rather than as pages of their own.
+  it("should render the sidebar and footer only when the wiki has them", () => {
+    // The page's own content is the last thing in its box, and the box is the
+    // only one on the page.
+    const bare = eta.render("wiki.eta", page);
+    assert.match(bare, /New to <strong>PhantomJS<\/strong>\?<\/p>\s*<\/div>/);
+    assert.doesNotMatch(bare, /Sidebar/);
+
+    const html = eta.render("wiki.eta", {
+      ...page,
+      sidebarHtml: "<ul><li>nav</li></ul>",
+      footerHtml: "<p>fine print</p>",
+    });
+    assert.match(html, /<footer>\s*<p>fine print<\/p>/);
+    assert.match(html, /<header><span>Sidebar<\/span><\/header>\s*<ul><li>nav<\/li><\/ul>/);
+  });
+
+  it("should link every page of the wiki", () => {
+    const html = eta.render("wiki.eta", page);
+
+    assert.match(html, /<summary>2 pages<\/summary>/);
+    assert.match(
+      html,
+      /href="\/ariya\/phantomjs\/wiki\/API-Reference-WebPage">API Reference WebPage/,
+    );
+  });
+
+  it("should list the pages with when each was last updated", () => {
+    const html = eta.render("wikiPages.eta", {
+      repo,
+      pages: [
+        {
+          name: "Home",
+          href: "/ariya/phantomjs/wiki",
+          updatedAt: "2018-02-08T18:57:56Z",
+        },
+      ],
+    });
+
+    assert.match(html, /href="\/ariya\/phantomjs\/wiki">Home/);
+    assert.match(html, /<time title="2018-02-08T18:57:56Z">2018-02-08<\/time>/);
+  });
+
+  // The editor and the timestamp are scraped independently, so a page missing
+  // one of them should still show the other.
+  it("should render each part of the header meta it has", () => {
+    assert.doesNotMatch(eta.render("wiki.eta", { ...page, updatedAt: null }), /<time/);
+    assert.match(eta.render("wiki.eta", { ...page, updatedAt: null }), /pixiuPL edited this page/);
+    assert.doesNotMatch(eta.render("wiki.eta", { ...page, updatedBy: null }), /edited this page/);
+  });
+
+  // GitHub reserves underscore-prefixed names for its own actions, so a page
+  // can never be one; the rest of them are for signed-in users only.
+  it("should not scrape a reserved wiki name as a page", async () => {
+    const reserved = ["/ariya/phantomjs/wiki/_new", "/ariya/phantomjs/wiki/Home/_edit"];
+    for (const path of reserved) {
+      const res = await app.request(`http://cgithub.example${path}`);
+
+      assert.strictEqual(res.status, 200);
+      assert.match(await res.text(), new RegExp(`url=https://github.com${path}"`));
+    }
+  });
+
+  it("should only read a revision off a path that names one", async () => {
+    const res = await app.request("http://cgithub.example/ariya/phantomjs/wiki/Home/latest");
+
+    assert.match(
+      await res.text(),
+      /url=https:\/\/github.com\/ariya\/phantomjs\/wiki\/Home\/latest"/,
+    );
+  });
+});
+
 describe("redirects to GitHub", () => {
   // An HTTP redirect would be caught by the extension's declarativeNetRequest
   // rules and bounced straight back here.
diff --git a/cgithub/src/app.ts b/cgithub/src/app.ts
index 33b408e..956a8cb 100644
--- a/cgithub/src/app.ts
+++ b/cgithub/src/app.ts
@@ -16,6 +16,8 @@ import {
   getGitHubReleases,
   getGitHubRepo,
   getGitHubTree,
+  getGitHubWiki,
+  getGitHubWikiPages,
   GitHubHTTPError,
   RedirectError,
 } from "./scraper.ts";
@@ -146,6 +148,36 @@ export function createApp(eta: Eta) {
     return new Response(response.body, { headers: { "Content-Type": contentType } });
   });
 
+  // GitHub's own wiki URLs, in the order it resolves them: names beginning with
+  // an underscore are reserved for its actions (_pages, _new, _edit, ...), so a
+  // page can never be mistaken for one.
+  app.get("/:owner/:repo/wiki", async (c) => {
+    const { owner, repo } = c.req.param();
+    return tryRender(c, "wiki.eta", getGitHubWiki(owner, repo));
+  });
+
+  app.get("/:owner/:repo/wiki/_pages", async (c) => {
+    const { owner, repo } = c.req.param();
+    return tryRender(c, "wikiPages.eta", getGitHubWikiPages(owner, repo));
+  });
+
+  // An older revision of a page renders exactly like its current one.
+  app.get("/:owner/:repo/wiki/:page/:oid", async (c) => {
+    const { owner, repo, page, oid } = c.req.param();
+    if (page.startsWith("_") || !/^[0-9a-f]{40}$/.test(oid)) {
+      return redirectToGitHub(c, githubUrlFor(c));
+    }
+    return tryRender(c, "wiki.eta", getGitHubWiki(owner, repo, page, oid));
+  });
+
+  app.get("/:owner/:repo/wiki/:page", async (c) => {
+    const { owner, repo, page } = c.req.param();
+    if (page.startsWith("_")) {
+      return redirectToGitHub(c, githubUrlFor(c));
+    }
+    return tryRender(c, "wiki.eta", getGitHubWiki(owner, repo, page));
+  });
+
   app.get("/:owner/:repo/issues", async (c) => {
     const { owner, repo } = c.req.param();
     const q = c.req.query("q");
diff --git a/cgithub/src/scraper.test.ts b/cgithub/src/scraper.test.ts
index 88e9271..372772b 100644
--- a/cgithub/src/scraper.test.ts
+++ b/cgithub/src/scraper.test.ts
@@ -14,6 +14,8 @@ import {
   getGitHubRepo,
   getGitHubOwner,
   getGitHubTree,
+  getGitHubWiki,
+  getGitHubWikiPages,
   GitHubHTTPError,
   RedirectError,
 } from "./scraper.ts";
@@ -384,6 +386,84 @@ describe("GitHub scraper", () => {
     });
   });
 
+  describe("wikis", () => {
+    it("should fetch the home page a wiki serves off /wiki itself", async () => {
+      const data = await getGitHubWiki("microsoft", "vscode");
+
+      assert.strictEqual(data.repo.owner, "microsoft");
+      assert.strictEqual(data.repo.name, "vscode");
+      assert.strictEqual(data.title, "Home");
+      assert.strictEqual(data.updatedBy, "Greg Van Liew");
+      assert.strictEqual(data.updatedAt, "2019-11-22T03:08:32Z");
+
+      assert.match(data.bodyHtml, /Welcome to the Visual Studio Code Wiki/);
+      // The _Sidebar and _Footer pages this wiki defines.
+      assert.match(data.sidebarHtml ?? "", /href="\/microsoft\/vscode\/wiki\/Roadmap"/);
+      assert.match(data.footerHtml ?? "", /Want to contribute to this Wiki\?/);
+    });
+
+    it("should fetch a page by its slug", async () => {
+      const data = await getGitHubWiki("microsoft", "vscode", "Commit-Signing");
+
+      assert.strictEqual(data.title, "Commit Signing");
+      assert.match(data.bodyHtml, /GPG/);
+    });
+
+    // The slug arrives from our route already decoded, so it has to be encoded
+    // again rather than interpolated into the URL as-is.
+    it("should fetch a page whose slug is not path-safe", async () => {
+      const data = await getGitHubWiki(
+        "microsoft",
+        "vscode",
+        "[DEV]-Perf-Tools-for-VS-Code-Development",
+      );
+
+      assert.strictEqual(data.title, "[DEV] Perf Tools for VS Code Development");
+      assert.ok(data.bodyHtml.length > 0);
+    });
+
+    it("should fetch an older revision of a page", async () => {
+      const oid = "f1c60035ba38b68ba383f58e482c312218daf86c";
+      const data = await getGitHubWiki("microsoft", "vscode", "Commit-Signing", oid);
+
+      assert.strictEqual(data.title, "Commit Signing");
+      assert.strictEqual(data.updatedBy, "Joaqu\u00edn Ruales");
+      assert.strictEqual(data.updatedAt, "2025-10-17T15:07:14Z");
+    });
+
+    // The sidebar list is complete; its "Show N more pages…" button only
+    // unhides the rest, so no second request is needed to link every page.
+    it("should collect every page from the sidebar of any page", async () => {
+      const data = await getGitHubWiki("microsoft", "vscode");
+
+      assert.ok(data.pages.length > 15);
+      assert.deepStrictEqual(data.pages[0], { name: "Home", href: "/microsoft/vscode/wiki" });
+      assert.ok(data.pages.some((page) => page.href === "/microsoft/vscode/wiki/Commit-Signing"));
+    });
+
+    // An archived repository, so neither its wiki nor these dates can move.
+    it("should fetch the page index with its last-updated dates", async () => {
+      const data = await getGitHubWikiPages("ariya", "phantomjs");
+
+      assert.strictEqual(data.repo.owner, "ariya");
+      assert.ok(data.pages.length > 1);
+      assert.ok(data.pages.every((page) => page.updatedAt));
+
+      const home = data.pages.find((page) => page.name === "Home");
+      assert.ok(home);
+      assert.strictEqual(home.href, "/ariya/phantomjs/wiki");
+      assert.strictEqual(home.updatedAt, "2018-02-08T18:57:56Z");
+    });
+
+    it("should redirect to the repository when it has no wiki", async () => {
+      await assert.rejects(getGitHubWiki("git", "git"), (err) => {
+        assert(err instanceof RedirectError, "error should be a RedirectError");
+        assert.strictEqual(err.location, "/git/git");
+        return true;
+      });
+    });
+  });
+
   describe("owner pages", () => {
     it("should fetch user profile", async () => {
       const data = await getGitHubOwner("torvalds");
diff --git a/cgithub/src/scraper.ts b/cgithub/src/scraper.ts
index c02cb5e..6461b19 100644
--- a/cgithub/src/scraper.ts
+++ b/cgithub/src/scraper.ts
@@ -1,5 +1,5 @@
 import { parseDocument } from "htmlparser2";
-import { type AnyNode, type Element } from "domhandler";
+import { isText, type AnyNode, type Element } from "domhandler";
 import { getAttributeValue, getInnerHTML, textContent } from "domutils";
 import * as cssSelect from "css-select";
 
@@ -352,6 +352,26 @@ export interface GitHubRelease extends GitHubCommon {
   release: Release;
 }
 
+export interface WikiPage {
+  name: string;
+  href: string;
+  updatedAt?: string;
+}
+
+export interface GitHubWiki extends GitHubCommon {
+  title: string;
+  updatedBy: string | null;
+  updatedAt: string | null;
+  bodyHtml: string;
+  sidebarHtml: string | null;
+  footerHtml: string | null;
+  pages: WikiPage[];
+}
+
+export interface GitHubWikiPages extends GitHubCommon {
+  pages: WikiPage[];
+}
+
 interface OwnerRepo {
   owner: string;
   name: string;
@@ -1109,3 +1129,96 @@ export async function getGitHubOwner(owner: string): Promise<GitHubOwner> {
   // Not a profile page (marketing pages like github.com/features, etc.).
   throw new RedirectError(`https://github.com/${owner}`);
 }
+
+// The text directly inside an element, ignoring any nested elements' text.
+function directText(elem: Element): string {
+  return elem.children
+    .filter(isText)
+    .map((node) => node.data)
+    .join("")
+    .replace(/\s+/g, " ")
+    .trim();
+}
+
+// The sidebar holds every wiki page, which are revealed by JavaScript.
+function parseWikiSidebarPages(document: AnyNode): WikiPage[] {
+  const pages: WikiPage[] = [];
+  const anchors = cssSelect.selectAll(
+    ".js-wiki-sidebar-page-container > div > a[href]",
+    document,
+  ) as unknown as Element[];
+  for (const anchor of anchors) {
+    const href = getAttributeValue(anchor, "href");
+    const name = textContent(anchor).replace(/\s+/g, " ").trim();
+    if (href && name) pages.push({ name, href });
+  }
+  return pages;
+}
+
+function wikiHtml(selector: string, document: AnyNode): string | null {
+  const elem = cssSelect.selectOne(selector, document);
+  if (!elem) return null;
+  const html = getInnerHTML(elem).trim();
+  return html || null;
+}
+
+export async function getGitHubWiki(
+  owner: string,
+  repo: string,
+  // Empty for the wiki's home page, which GitHub serves off /wiki itself.
+  page = "",
+  // A revision SHA renders that older version of the page.
+  oid = "",
+): Promise<GitHubWiki> {
+  // Page names keep characters that are not path-safe (C#, [DEV] ...), so the
+  // slug has to be re-encoded rather than interpolated the way a ref is.
+  const path = [`${owner}/${repo}/wiki`, page && encodeURIComponent(page), oid]
+    .filter(Boolean)
+    .join("/");
+  const html = await fetchGitHubPage(path);
+  const document = parseDocument(html);
+
+  const heading = cssSelect.selectOne("h1.gh-header-title", document) as Element | null;
+  if (!heading) {
+    throw new Error("Could not find the wiki page heading");
+  }
+
+  // "<author> edited this page <date> · <n> revisions", where the author is the
+  // only part not wrapped in an element of its own.
+  const meta = cssSelect.selectOne(".gh-header-meta", document) as Element | null;
+  const updatedBy = meta ? (/^(.+?) edited this page\b/.exec(directText(meta))?.[1] ?? null) : null;
+  const time = meta ? cssSelect.selectOne("relative-time", meta) : null;
+
+  return {
+    repo: { owner, name: repo },
+    title: directText(heading),
+    updatedBy,
+    updatedAt: time ? getAttributeValue(time, "datetime") || null : null,
+    bodyHtml: wikiHtml("#wiki-body .markdown-body", document) ?? "",
+    // Wikis can define _Sidebar and _Footer pages, rendered alongside every page.
+    sidebarHtml: wikiHtml(".wiki-custom-sidebar", document),
+    footerHtml: wikiHtml("#wiki-footer .markdown-body", document),
+    pages: parseWikiSidebarPages(document),
+  };
+}
+
+export async function getGitHubWikiPages(owner: string, repo: string): Promise<GitHubWikiPages> {
+  const html = await fetchGitHubPage(`${owner}/${repo}/wiki/_pages`);
+  const document = parseDocument(html);
+
+  const pages: WikiPage[] = [];
+  for (const row of cssSelect.selectAll(
+    "#wiki-content li.Box-row",
+    document,
+  ) as unknown as Element[]) {
+    const anchor = cssSelect.selectOne("a[href]", row) as Element | null;
+    const href = anchor ? getAttributeValue(anchor, "href") : undefined;
+    const name = anchor ? textContent(anchor).replace(/\s+/g, " ").trim() : "";
+    if (!href || !name) continue;
+
+    const time = cssSelect.selectOne("relative-time", row) as Element | null;
+    pages.push({ name, href, updatedAt: time ? getAttributeValue(time, "datetime") : undefined });
+  }
+
+  return { repo: { owner, name: repo }, pages };
+}
diff --git a/cgithub/views/_wikiNav.eta b/cgithub/views/_wikiNav.eta
new file mode 100644
index 0000000..cc177c7
--- /dev/null
+++ b/cgithub/views/_wikiNav.eta
@@ -0,0 +1,4 @@
+<nav>
+  <a href="/<%= it.repo.owner %>/<%= it.repo.name %>/wiki">Wiki home</a>
+  <a href="/<%= it.repo.owner %>/<%= it.repo.name %>/wiki/_pages">Pages</a>
+</nav>
diff --git a/cgithub/views/layout.eta b/cgithub/views/layout.eta
index 6d1b052..1ac82cc 100644
--- a/cgithub/views/layout.eta
+++ b/cgithub/views/layout.eta
@@ -17,6 +17,7 @@ git clone git@github.com:<%= it.repo.owner %>/<%= it.repo.name %>.git</code></pr
       <a href="/<%= it.repo.owner %>/<%= it.repo.name %>/issues">Issues</a>
       <a href="/<%= it.repo.owner %>/<%= it.repo.name %>/pulls">Pull requests</a>
       <a href="/<%= it.repo.owner %>/<%= it.repo.name %>/releases">Releases</a>
+      <a href="/<%= it.repo.owner %>/<%= it.repo.name %>/wiki">Wiki</a>
       <% if (it.branch) { %>
         <a href="/<%= it.repo.owner %>/<%= it.repo.name %>/commits/<%= it.branch %><%= it.path && it.path !== '/' ? '/' + it.path : '' %>">Commits</a>
       <% } %>
diff --git a/cgithub/views/wiki.eta b/cgithub/views/wiki.eta
new file mode 100644
index 0000000..d6047e1
--- /dev/null
+++ b/cgithub/views/wiki.eta
@@ -0,0 +1,37 @@
+<% layout("./layout.eta"); it.path = "wiki/" + it.title %>
+
+<%~ include("./_wikiNav.eta", it) %>
+
+<div class="box wiki">
+  <header>
+    <span><%= it.title %></span>
+    <% if (it.updatedBy || it.updatedAt) { %>
+      <span class="timestamp">
+        <% if (it.updatedBy) { %><%= it.updatedBy %> edited this page<% } %>
+        <% if (it.updatedAt) { %><time title="<%= it.updatedAt %>"><%= it.updatedAt.split("T")[0] %></time><% } %>
+      </span>
+    <% } %>
+  </header>
+  <%~ it.bodyHtml %>
+  <% if (it.footerHtml) { %>
+    <footer><%~ it.footerHtml %></footer>
+  <% } %>
+</div>
+
+<% if (it.sidebarHtml) { %>
+  <div class="box wiki">
+    <header><span>Sidebar</span></header>
+    <%~ it.sidebarHtml %>
+  </div>
+<% } %>
+
+<% if (it.pages.length > 0) { %>
+  <details class="box wiki-pages">
+    <summary><%= it.pages.length %> page<%= it.pages.length === 1 ? "" : "s" %></summary>
+    <ul>
+      <% for (const page of it.pages) { %>
+        <li><a href="<%= page.href %>"><%= page.name %></a></li>
+      <% } %>
+    </ul>
+  </details>
+<% } %>
diff --git a/cgithub/views/wikiPages.eta b/cgithub/views/wikiPages.eta
new file mode 100644
index 0000000..58d6d21
--- /dev/null
+++ b/cgithub/views/wikiPages.eta
@@ -0,0 +1,16 @@
+<% layout("./layout.eta"); it.path = "wiki/_pages" %>
+
+<%~ include("./_wikiNav.eta", it) %>
+
+<table>
+  <% for (const page of it.pages) { %>
+    <tr>
+      <td><a href="<%= page.href %>"><%= page.name %></a></td>
+      <td class="timestamp">
+        <% if (page.updatedAt) { %>
+          <time title="<%= page.updatedAt %>"><%= page.updatedAt.split("T")[0] %></time>
+        <% } %>
+      </td>
+    </tr>
+  <% } %>
+</table>
-- 
cgit v1.3.1


From 439f783c9e3b18519505d1ad6b8533bea081cca0 Mon Sep 17 00:00:00 2001
From: Joe Mou <dev@mou.fo>
Date: Thu, 3 Sep 2026 15:07:25 -0400
Subject: Clean up renderer, redirects, and build commit

---
 cgithub/.gitignore       |  2 +-
 cgithub/CLAUDE.md        |  2 +-
 cgithub/scripts/build.ts | 12 ++++-----
 cgithub/src/app.test.ts  |  8 ++++--
 cgithub/src/app.ts       | 63 ++++++++++++++++++++++++++++++------------------
 cgithub/views/layout.eta |  2 +-
 6 files changed, 54 insertions(+), 35 deletions(-)

(limited to 'cgithub/src/app.ts')

diff --git a/cgithub/.gitignore b/cgithub/.gitignore
index b8fc600..55b5412 100644
--- a/cgithub/.gitignore
+++ b/cgithub/.gitignore
@@ -1,4 +1,4 @@
 /node_modules/
 /.wrangler/
-/src/commit.generated.ts
+/src/build.generated.ts
 /src/views.generated.ts
diff --git a/cgithub/CLAUDE.md b/cgithub/CLAUDE.md
index 3f0cd61..edb33f5 100644
--- a/cgithub/CLAUDE.md
+++ b/cgithub/CLAUDE.md
@@ -24,7 +24,7 @@ pnpm test
 - `src/worker.ts` - Cloudflare Workers entry (config in `wrangler.jsonc`)
 - `src/scraper.ts` - GitHub HTML fetching and JSON extraction logic
 
-**Templates:** `views/*.eta` - Eta templates with layout inheritance (`layout.eta` as base). On Workers, runtime code generation is disallowed, so `scripts/build.ts` precompiles templates to `src/views.generated.ts`. The same script records the build's `git describe` output in `src/commit.generated.ts` for the page footer. Both are gitignored and regenerated by the `dev`/`deploy` scripts.
+**Templates:** `views/*.eta` - Eta templates with layout inheritance (`layout.eta` as base). On Workers, runtime code generation is disallowed, so `scripts/build.ts` precompiles templates to `src/views.generated.ts`. The same script records the build's `git describe` output in `src/build.generated.ts` for the page footer. Both are gitignored and regenerated by the `dev`/`deploy` scripts.
 
 **Static files:** `public/static/*`, served by Workers Static Assets.
 
diff --git a/cgithub/scripts/build.ts b/cgithub/scripts/build.ts
index 766e5e8..76d88a0 100644
--- a/cgithub/scripts/build.ts
+++ b/cgithub/scripts/build.ts
@@ -3,7 +3,7 @@
 //   src/views.generated.ts  - views/*.eta precompiled into plain functions.
 //     Workers disallow runtime code generation (`new Function`), so Eta cannot
 //     compile templates there at request time.
-//   src/commit.generated.ts - the commit this build was made from, for the
+//   src/build.generated.ts  - the commit this build was made from, for the
 //     page footer. Workers can't shell out to git at request time either.
 import { execFileSync } from "node:child_process";
 import { Eta } from "eta";
@@ -35,9 +35,9 @@ console.log(`Compiled ${names.length} templates to src/views.generated.ts`);
 
 // Untagged repositories describe as a bare short hash; --dirty marks a build
 // made from an unclean working copy.
-let commit = "unknown";
+let buildCommit = "unknown";
 try {
-  commit = execFileSync("git", ["describe", "--tags", "--always", "--dirty"], {
+  buildCommit = execFileSync("git", ["describe", "--tags", "--always", "--dirty"], {
     cwd: root,
     encoding: "utf8",
   }).trim();
@@ -46,7 +46,7 @@ try {
 }
 
 fs.writeFileSync(
-  path.join(root, "src", "commit.generated.ts"),
-  `// Generated by scripts/build.ts -- do not edit.\nexport const commit = ${JSON.stringify(commit)};\n`,
+  path.join(root, "src", "build.generated.ts"),
+  `// Generated by scripts/build.ts -- do not edit.\nexport const buildCommit = ${JSON.stringify(buildCommit)};\n`,
 );
-console.log(`Wrote commit ${commit} to src/commit.generated.ts`);
+console.log(`Wrote commit ${buildCommit} to src/build.generated.ts`);
diff --git a/cgithub/src/app.test.ts b/cgithub/src/app.test.ts
index 8519d91..274b2d5 100644
--- a/cgithub/src/app.test.ts
+++ b/cgithub/src/app.test.ts
@@ -195,7 +195,10 @@ describe("commit history", () => {
 
     assert.match(html, /href="\/actions\/deploy-pages\/commits\/main">\(top\)</);
     assert.match(html, /href="\/actions\/deploy-pages\/commits\/main\/src">src</);
-    assert.match(html, /href="\/actions\/deploy-pages\/commits\/main\/src\/lib">lib<\/a>\/index\.js/);
+    assert.match(
+      html,
+      /href="\/actions\/deploy-pages\/commits\/main\/src\/lib">lib<\/a>\/index\.js/,
+    );
   });
 
   it("should say so when a path has no history", () => {
@@ -363,9 +366,9 @@ describe("redirects to GitHub", () => {
 
     assert.strictEqual(res.status, 200);
     assert.strictEqual(res.headers.get("location"), null);
-    assert.strictEqual(res.headers.get("Referrer-Policy"), "no-referrer");
 
     const body = await res.text();
+    assert.match(body, /<meta name="referrer" content="no-referrer">/);
     assert.match(
       body,
       /<meta http-equiv="refresh" content="1; url=https:\/\/github.com\/a\/b\/c\?x=1">/,
@@ -382,6 +385,7 @@ describe("redirects to GitHub", () => {
 
     assert.strictEqual(res.status, 302);
     assert.strictEqual(res.headers.get("location"), "https://github.com/a/b/c?x=1");
+    assert.strictEqual(res.headers.get("Referrer-Policy"), "no-referrer");
   });
 
   it("should use a meta refresh when the referer is another site", async () => {
diff --git a/cgithub/src/app.ts b/cgithub/src/app.ts
index 956a8cb..bbe07fc 100644
--- a/cgithub/src/app.ts
+++ b/cgithub/src/app.ts
@@ -1,7 +1,7 @@
 import type { Eta } from "eta";
 import { type Context, Hono } from "hono";
 import type { StatusCode } from "hono/utils/http-status";
-import { commit } from "./commit.generated.ts";
+import { buildCommit } from "./build.generated.ts";
 import {
   getGitHubBlob,
   getGitHubCommits,
@@ -22,7 +22,12 @@ import {
   RedirectError,
 } from "./scraper.ts";
 
-// Our URLs mirror GitHub's, so the same path there is the page we scraped.
+declare module "hono" {
+  interface ContextRenderer {
+    (template: string, data?: object): Response;
+  }
+}
+
 function githubUrlFor(c: Context) {
   const { pathname, search } = new URL(c.req.url);
   return `https://github.com${pathname}${search}`;
@@ -31,23 +36,36 @@ function githubUrlFor(c: Context) {
 export function createApp(eta: Eta) {
   const app = new Hono();
 
-  // Use a meta refresh to avoid redirect loops in certain situations; we become
-  // the initiator origin even if we are the target of a redirection. Requests
-  // coming from one of our own pages are already past that hazard, and are
-  // often subresources (an <img> in a rendered README) that can't do anything
-  // with an HTML page, so those get a real HTTP redirect.
-  function redirectToGitHub(c: Context, location: string) {
+  app.use(async (c, next) => {
+    // Include render data for layout.eta.
+    c.setRenderer((template, data) =>
+      c.html(eta.render(template, { ...data, githubUrl: githubUrlFor(c), buildCommit })),
+    );
+    await next();
+  });
+
+  // Redirect off-domain.
+  function redirectTo(c: Context, location: string) {
     const referer = c.req.header("Referer");
+    // If we are the referer, redirect directly so we can hotlink resources
+    // (e.g., <img> in README).
     if (referer && URL.parse(referer)?.origin === new URL(c.req.url).origin) {
+      c.header("Referrer-Policy", "no-referrer");
       return c.redirect(location);
     }
 
-    c.header("Referrer-Policy", "no-referrer");
-    return c.html(eta.render("redirect.eta", { location }));
+    // Otherwise use a meta refresh to make ourself the initiator. This will
+    // avoid redirect loops if we are part of excludedInitiatorDomains in a
+    // declarativeNetRequest.
+    return c.render("redirect.eta", { location });
+  }
+
+  function redirectToGitHub(c: Context) {
+    return redirectTo(c, githubUrlFor(c));
   }
 
   app.get("/", async (c) => {
-    return c.html(eta.render("home.eta", {}));
+    return c.render("home.eta");
   });
 
   async function tryRender<T extends object>(c: Context, template: string, promise: Promise<T>) {
@@ -57,19 +75,19 @@ export function createApp(eta: Eta) {
     } catch (e) {
       if (e instanceof RedirectError) {
         if (e.location.startsWith("https://")) {
-          return redirectToGitHub(c, e.location);
+          return redirectTo(c, e.location);
         }
         return c.redirect(e.location);
       } else if (e instanceof GitHubHTTPError) {
         c.status(e.status as StatusCode);
         const message = `GitHub responded with HTTP ${e.status} ${e.message}`;
-        return c.html(eta.render("error.eta", { title: e.message, message }));
+        return c.render("error.eta", { title: e.message, message });
       } else {
         c.status(500);
-        return c.html(eta.render("error.eta", { message: "" + e }));
+        return c.render("error.eta", { message: "" + e });
       }
     }
-    return c.html(eta.render(template, { ...data, githubUrl: githubUrlFor(c), commit }));
+    return c.render(template, data);
   }
 
   // For fragments fetched asynchronously by client-side JS (see public/static/refs.js):
@@ -92,7 +110,7 @@ export function createApp(eta: Eta) {
       c.status(status);
       return c.body(null);
     }
-    return c.html(eta.render(template, data));
+    return c.render(template, data);
   }
 
   app.get("/:owner", async (c) => {
@@ -117,10 +135,7 @@ export function createApp(eta: Eta) {
 
   app.get("/:owner/:repo/raw/:branch/:path{.*}", async (c) => {
     const { owner, repo, branch, path } = c.req.param();
-    return redirectToGitHub(
-      c,
-      `https://raw.githubusercontent.com/${owner}/${repo}/${branch}/${path}`,
-    );
+    return redirectTo(c, `https://raw.githubusercontent.com/${owner}/${repo}/${branch}/${path}`);
   });
 
   // This is not a native GitHub route, but instead it lets us render blob
@@ -165,7 +180,7 @@ export function createApp(eta: Eta) {
   app.get("/:owner/:repo/wiki/:page/:oid", async (c) => {
     const { owner, repo, page, oid } = c.req.param();
     if (page.startsWith("_") || !/^[0-9a-f]{40}$/.test(oid)) {
-      return redirectToGitHub(c, githubUrlFor(c));
+      return redirectToGitHub(c);
     }
     return tryRender(c, "wiki.eta", getGitHubWiki(owner, repo, page, oid));
   });
@@ -173,7 +188,7 @@ export function createApp(eta: Eta) {
   app.get("/:owner/:repo/wiki/:page", async (c) => {
     const { owner, repo, page } = c.req.param();
     if (page.startsWith("_")) {
-      return redirectToGitHub(c, githubUrlFor(c));
+      return redirectToGitHub(c);
     }
     return tryRender(c, "wiki.eta", getGitHubWiki(owner, repo, page));
   });
@@ -209,7 +224,7 @@ export function createApp(eta: Eta) {
     }
 
     // Redirect unhandled search types (like code, which requires sign in anyway).
-    return redirectToGitHub(c, githubUrlFor(c));
+    return redirectToGitHub(c);
   });
 
   app.get("/:owner/:repo/commits/:branch/:path{.*}?", async (c) => {
@@ -260,7 +275,7 @@ export function createApp(eta: Eta) {
   });
 
   app.all("*", async (c) => {
-    return redirectToGitHub(c, githubUrlFor(c));
+    return redirectToGitHub(c);
   });
 
   return app;
diff --git a/cgithub/views/layout.eta b/cgithub/views/layout.eta
index 1ac82cc..37289dd 100644
--- a/cgithub/views/layout.eta
+++ b/cgithub/views/layout.eta
@@ -35,7 +35,7 @@ git clone git@github.com:<%= it.repo.owner %>/<%= it.repo.name %>.git</code></pr
 
   <%~ it.body %>
 
-  <footer>Generated by cgithub commit <code><%= it.commit %></code> · <a href="<%= it.githubUrl %>" rel="noreferrer">View original</a></footer>
+  <footer>Generated by cgithub commit <code><%= it.buildCommit %></code> · <a href="<%= it.githubUrl %>" rel="noreferrer">View original</a></footer>
 
   <script>
     document.addEventListener("keydown", function(e) {
-- 
cgit v1.3.1


From 5bfe8b345d2ee92111a2363321a248adb4f5195a Mon Sep 17 00:00:00 2001
From: Joe Mou <dev@mou.fo>
Date: Thu, 3 Sep 2026 23:08:08 -0400
Subject: Handle route errors in middleware

Every page route wrapped its scrape in tryRender, which awaited the
promise, rendered the template on success, and turned a failure into a
redirect or an error page. Hono's onError does that mapping for all of
them at once, so handlers now await their scrape inline and both
wrappers are gone. Fragments under /api/ still fail as an empty body
rather than a page; onError checks for them first, since a fragment
turns a redirect into a 404 instead of following it.

RedirectError becomes an abstract base with InternalRedirectError and
ExternalRedirectError under it, so the handler dispatches on the type
instead of sniffing the location for an https:// prefix.

One behavior change: a thrown value that is not an Error no longer
renders error.eta, because Hono only routes Error instances to onError.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QERwoRJhuqMhKzzCUW4Skv
---
 cgithub/src/app.ts          | 104 +++++++++++++++++---------------------------
 cgithub/src/scraper.test.ts |  13 +++---
 cgithub/src/scraper.ts      |  12 +++--
 3 files changed, 56 insertions(+), 73 deletions(-)

(limited to 'cgithub/src/app.ts')

diff --git a/cgithub/src/app.ts b/cgithub/src/app.ts
index bbe07fc..2fa5832 100644
--- a/cgithub/src/app.ts
+++ b/cgithub/src/app.ts
@@ -18,7 +18,9 @@ import {
   getGitHubTree,
   getGitHubWiki,
   getGitHubWikiPages,
+  ExternalRedirectError,
   GitHubHTTPError,
+  InternalRedirectError,
   RedirectError,
 } from "./scraper.ts";
 
@@ -64,73 +66,53 @@ export function createApp(eta: Eta) {
     return redirectTo(c, githubUrlFor(c));
   }
 
-  app.get("/", async (c) => {
-    return c.render("home.eta");
-  });
-
-  async function tryRender<T extends object>(c: Context, template: string, promise: Promise<T>) {
-    let data: T;
-    try {
-      data = await promise;
-    } catch (e) {
-      if (e instanceof RedirectError) {
-        if (e.location.startsWith("https://")) {
-          return redirectTo(c, e.location);
-        }
-        return c.redirect(e.location);
-      } else if (e instanceof GitHubHTTPError) {
-        c.status(e.status as StatusCode);
-        const message = `GitHub responded with HTTP ${e.status} ${e.message}`;
-        return c.render("error.eta", { title: e.message, message });
-      } else {
-        c.status(500);
-        return c.render("error.eta", { message: "" + e });
-      }
-    }
-    return c.render(template, data);
-  }
-
-  // For fragments fetched asynchronously by client-side JS (see public/static/refs.js):
-  // errors render as an empty body rather than the full error.eta page.
-  async function tryRenderFragment<T extends object>(
-    c: Context,
-    template: string,
-    promise: Promise<T>,
-  ) {
-    let data: T;
-    try {
-      data = await promise;
-    } catch (e) {
-      const status =
+  app.onError((e, c) => {
+    // Fragments fetched asynchronously by client-side JS (see public/static/refs.js)
+    // fail as an empty body rather than the full error.eta page.
+    if (c.req.path.startsWith("/api/")) {
+      c.status(
         e instanceof GitHubHTTPError
           ? (e.status as StatusCode)
           : e instanceof RedirectError
             ? 404
-            : 500;
-      c.status(status);
+            : 500,
+      );
       return c.body(null);
     }
-    return c.render(template, data);
-  }
+
+    if (e instanceof InternalRedirectError) return c.redirect(e.location);
+    if (e instanceof ExternalRedirectError) return redirectTo(c, e.location);
+    if (e instanceof GitHubHTTPError) {
+      c.status(e.status as StatusCode);
+      const message = `GitHub responded with HTTP ${e.status} ${e.message}`;
+      return c.render("error.eta", { title: e.message, message });
+    }
+    c.status(500);
+    return c.render("error.eta", { message: "" + e });
+  });
+
+  app.get("/", async (c) => {
+    return c.render("home.eta");
+  });
 
   app.get("/:owner", async (c) => {
     const { owner } = c.req.param();
-    return tryRender(c, "owner.eta", getGitHubOwner(owner));
+    return c.render("owner.eta", await getGitHubOwner(owner));
   });
 
   app.get("/:owner/:repo", async (c) => {
     const { owner, repo } = c.req.param();
-    return tryRender(c, "repo.eta", getGitHubRepo(owner, repo));
+    return c.render("repo.eta", await getGitHubRepo(owner, repo));
   });
 
   app.get("/:owner/:repo/tree/:branch/:path{.*}?", async (c) => {
     const { owner, repo, branch, path = "" } = c.req.param();
-    return tryRender(c, "tree.eta", getGitHubTree(owner, repo, branch, path));
+    return c.render("tree.eta", await getGitHubTree(owner, repo, branch, path));
   });
 
   app.get("/:owner/:repo/blob/:branch/:path{.*}", async (c) => {
     const { owner, repo, branch, path } = c.req.param();
-    return tryRender(c, "blob.eta", getGitHubBlob(owner, repo, branch, path));
+    return c.render("blob.eta", await getGitHubBlob(owner, repo, branch, path));
   });
 
   app.get("/:owner/:repo/raw/:branch/:path{.*}", async (c) => {
@@ -168,12 +150,12 @@ export function createApp(eta: Eta) {
   // page can never be mistaken for one.
   app.get("/:owner/:repo/wiki", async (c) => {
     const { owner, repo } = c.req.param();
-    return tryRender(c, "wiki.eta", getGitHubWiki(owner, repo));
+    return c.render("wiki.eta", await getGitHubWiki(owner, repo));
   });
 
   app.get("/:owner/:repo/wiki/_pages", async (c) => {
     const { owner, repo } = c.req.param();
-    return tryRender(c, "wikiPages.eta", getGitHubWikiPages(owner, repo));
+    return c.render("wikiPages.eta", await getGitHubWikiPages(owner, repo));
   });
 
   // An older revision of a page renders exactly like its current one.
@@ -182,7 +164,7 @@ export function createApp(eta: Eta) {
     if (page.startsWith("_") || !/^[0-9a-f]{40}$/.test(oid)) {
       return redirectToGitHub(c);
     }
-    return tryRender(c, "wiki.eta", getGitHubWiki(owner, repo, page, oid));
+    return c.render("wiki.eta", await getGitHubWiki(owner, repo, page, oid));
   });
 
   app.get("/:owner/:repo/wiki/:page", async (c) => {
@@ -190,7 +172,7 @@ export function createApp(eta: Eta) {
     if (page.startsWith("_")) {
       return redirectToGitHub(c);
     }
-    return tryRender(c, "wiki.eta", getGitHubWiki(owner, repo, page));
+    return c.render("wiki.eta", await getGitHubWiki(owner, repo, page));
   });
 
   app.get("/:owner/:repo/issues", async (c) => {
@@ -203,13 +185,13 @@ export function createApp(eta: Eta) {
       return c.redirect(`/${owner}/${repo}/issues?q=${encodeURIComponent(`is:issue ${q}`)}`);
     }
 
-    return tryRender(c, "issues.eta", getGitHubIssues(owner, repo, { q }));
+    return c.render("issues.eta", await getGitHubIssues(owner, repo, { q }));
   });
 
   app.get("/:owner/:repo/pulls", async (c) => {
     const { owner, repo } = c.req.param();
     const q = c.req.query("q");
-    return tryRender(c, "pulls.eta", getGitHubPulls(owner, repo, { q }));
+    return c.render("pulls.eta", await getGitHubPulls(owner, repo, { q }));
   });
 
   app.get("/:owner/:repo/search", async (c) => {
@@ -229,7 +211,7 @@ export function createApp(eta: Eta) {
 
   app.get("/:owner/:repo/commits/:branch/:path{.*}?", async (c) => {
     const { owner, repo, branch, path = "" } = c.req.param();
-    return tryRender(c, "commits.eta", getGitHubCommits(owner, repo, branch, path));
+    return c.render("commits.eta", await getGitHubCommits(owner, repo, branch, path));
   });
 
   // Internal endpoints fetched asynchronously by client-side JS, not meant to
@@ -246,32 +228,28 @@ export function createApp(eta: Eta) {
     if (view !== "tree" && view !== "blob" && view !== "commits") {
       return c.notFound();
     }
-    const refs = getGitHubRefs(owner, repo, type).then((data) => ({ ...data, view, path }));
-    return tryRenderFragment(c, "_refs.eta", refs);
+    const refs = await getGitHubRefs(owner, repo, type);
+    return c.render("_refs.eta", { ...refs, view, path });
   });
 
   app.get("/api/:owner/:repo/latest-commit/:branch/:path{.*}?", async (c) => {
     const { owner, repo, branch, path = "" } = c.req.param();
-    return tryRenderFragment(
-      c,
-      "_latestCommit.eta",
-      getGitHubLatestCommit(owner, repo, branch, path),
-    );
+    return c.render("_latestCommit.eta", await getGitHubLatestCommit(owner, repo, branch, path));
   });
 
   app.get("/api/:owner/:repo/sidebar", async (c) => {
     const { owner, repo } = c.req.param();
-    return tryRenderFragment(c, "_sidebar.eta", getGitHubSidebar(owner, repo));
+    return c.render("_sidebar.eta", await getGitHubSidebar(owner, repo));
   });
 
   app.get("/:owner/:repo/releases/tag/:tag", async (c) => {
     const { owner, repo, tag } = c.req.param();
-    return tryRender(c, "release.eta", getGitHubRelease(owner, repo, tag));
+    return c.render("release.eta", await getGitHubRelease(owner, repo, tag));
   });
 
   app.get("/:owner/:repo/releases", async (c) => {
     const { owner, repo } = c.req.param();
-    return tryRender(c, "releases.eta", getGitHubReleases(owner, repo));
+    return c.render("releases.eta", await getGitHubReleases(owner, repo));
   });
 
   app.all("*", async (c) => {
diff --git a/cgithub/src/scraper.test.ts b/cgithub/src/scraper.test.ts
index f6be2b6..8dcb0b8 100644
--- a/cgithub/src/scraper.test.ts
+++ b/cgithub/src/scraper.test.ts
@@ -16,8 +16,9 @@ import {
   getGitHubTree,
   getGitHubWiki,
   getGitHubWikiPages,
+  ExternalRedirectError,
   GitHubHTTPError,
-  RedirectError,
+  InternalRedirectError,
 } from "./scraper.ts";
 
 describe("GitHub scraper", () => {
@@ -215,7 +216,7 @@ describe("GitHub scraper", () => {
       const oid = "b39c421b98f49d83ae50ec502c3ddfc3bf28f2c6";
 
       await assert.rejects(getGitHubTree("actions", "deploy-pages", oid, "src/index.js"), (err) => {
-        assert(err instanceof RedirectError, "error should be a RedirectError");
+        assert(err instanceof InternalRedirectError, "error should be an InternalRedirectError");
         assert.strictEqual(err.location, `/actions/deploy-pages/blob/${oid}/src/index.js`);
         return true;
       });
@@ -490,7 +491,7 @@ describe("GitHub scraper", () => {
 
     it("should redirect to the repository when it has no wiki", async () => {
       await assert.rejects(getGitHubWiki("git", "git"), (err) => {
-        assert(err instanceof RedirectError, "error should be a RedirectError");
+        assert(err instanceof InternalRedirectError, "error should be an InternalRedirectError");
         assert.strictEqual(err.location, "/git/git");
         return true;
       });
@@ -571,7 +572,7 @@ describe("GitHub scraper", () => {
 
     it("should redirect to GitHub for non-profile pages", async () => {
       await assert.rejects(getGitHubOwner("features"), (err) => {
-        assert(err instanceof RedirectError, "error should be a RedirectError");
+        assert(err instanceof ExternalRedirectError, "error should be an ExternalRedirectError");
         assert.strictEqual(err.location, "https://github.com/features");
         return true;
       });
@@ -599,7 +600,7 @@ describe("GitHub scraper", () => {
       await assert.rejects(
         getGitHubBlob("earendil-works", "pi", "main", "packages/agent"),
         (err) => {
-          assert(err instanceof RedirectError, "error should be a RedirectError");
+          assert(err instanceof InternalRedirectError, "error should be an InternalRedirectError");
           assert.strictEqual(err.location, "/earendil-works/pi/tree/main/packages/agent");
           return true;
         },
@@ -610,7 +611,7 @@ describe("GitHub scraper", () => {
       await assert.rejects(
         getGitHubTree("earendil-works", "pi", "main", "packages/agent/package.json"),
         (err) => {
-          assert(err instanceof RedirectError, "error should be a RedirectError");
+          assert(err instanceof InternalRedirectError, "error should be an InternalRedirectError");
           assert.strictEqual(
             err.location,
             "/earendil-works/pi/blob/main/packages/agent/package.json",
diff --git a/cgithub/src/scraper.ts b/cgithub/src/scraper.ts
index 6461b19..fb48700 100644
--- a/cgithub/src/scraper.ts
+++ b/cgithub/src/scraper.ts
@@ -13,16 +13,20 @@ export class GitHubHTTPError extends Error {
   }
 }
 
-export class RedirectError extends Error {
+export abstract class RedirectError extends Error {
   location: string;
 
   constructor(location: string) {
     super(`Redirect to ${location}`);
-    this.name = "RedirectError";
+    this.name = this.constructor.name;
     this.location = location;
   }
 }
 
+export class InternalRedirectError extends RedirectError {}
+
+export class ExternalRedirectError extends RedirectError {}
+
 interface TreeItem {
   contentType: "directory" | "file";
   name: string;
@@ -423,7 +427,7 @@ async function fetchGitHubResponse(path: string, accept: string): Promise<Respon
     if (location) {
       const url = new URL(location);
       if (url.hostname === "github.com") {
-        throw new RedirectError(url.pathname);
+        throw new InternalRedirectError(url.pathname);
       }
     }
   }
@@ -1127,7 +1131,7 @@ export async function getGitHubOwner(owner: string): Promise<GitHubOwner> {
     return parseOrganization(document, owner);
   }
   // Not a profile page (marketing pages like github.com/features, etc.).
-  throw new RedirectError(`https://github.com/${owner}`);
+  throw new ExternalRedirectError(`https://github.com/${owner}`);
 }
 
 // The text directly inside an element, ignoring any nested elements' text.
-- 
cgit v1.3.1


From 53ac3bc511a45e4e2e3f234a8b8dcf853b0c38d9 Mon Sep 17 00:00:00 2001
From: Joe Mou <dev@mou.fo>
Date: Fri, 4 Sep 2026 21:26:21 -0400
Subject: Split the page shell out of the repository layout

layout.eta was two things at once: the HTML shell every page needs and
the repository chrome around it. owner.eta, being the one page that is
not about a repository, could use neither and carried its own copy of
the shell, which had drifted -- its footer named no build commit and
did not link to the original page on GitHub.

The shell moves to views/layouts/base.eta, taking its title and any
deferred scripts as layout data, and the chrome to views/layouts/repo.eta,
a layout over it that adds the clone commands, nav, search box, and the
"/" shortcut that focuses it. Repository pages point at repo.eta and
render as before; owner.eta uses base.eta directly and so gains the
footer it was missing.

Templates now live in more than one directory, so scripts/build.ts walks
views/ recursively and keys each template by its path underneath it.
Names crossing a directory are written from the views root
("/layouts/base.eta"), the one form both Eta's filesystem resolver and
the precompiled resolver in worker.ts agree on; siblings stay relative.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Ba5p88cWtCq42vf3uweweL
---
 cgithub/CLAUDE.md              |   2 +-
 cgithub/scripts/build.ts       |  20 ++++++--
 cgithub/src/app.ts             |   2 +-
 cgithub/src/worker.ts          |   5 +-
 cgithub/views/blob.eta         |   2 +-
 cgithub/views/commits.eta      |   2 +-
 cgithub/views/issues.eta       |   2 +-
 cgithub/views/layout.eta       |  66 -------------------------
 cgithub/views/layouts/base.eta |  17 +++++++
 cgithub/views/layouts/repo.eta |  59 +++++++++++++++++++++++
 cgithub/views/owner.eta        | 107 ++++++++++++++++++-----------------------
 cgithub/views/pulls.eta        |   2 +-
 cgithub/views/release.eta      |   2 +-
 cgithub/views/releases.eta     |   2 +-
 cgithub/views/repo.eta         |   2 +-
 cgithub/views/tree.eta         |   2 +-
 cgithub/views/wiki.eta         |   2 +-
 cgithub/views/wikiPages.eta    |   2 +-
 18 files changed, 156 insertions(+), 142 deletions(-)
 delete mode 100644 cgithub/views/layout.eta
 create mode 100644 cgithub/views/layouts/base.eta
 create mode 100644 cgithub/views/layouts/repo.eta

(limited to 'cgithub/src/app.ts')

diff --git a/cgithub/CLAUDE.md b/cgithub/CLAUDE.md
index edb33f5..6c6dc60 100644
--- a/cgithub/CLAUDE.md
+++ b/cgithub/CLAUDE.md
@@ -24,7 +24,7 @@ pnpm test
 - `src/worker.ts` - Cloudflare Workers entry (config in `wrangler.jsonc`)
 - `src/scraper.ts` - GitHub HTML fetching and JSON extraction logic
 
-**Templates:** `views/*.eta` - Eta templates with layout inheritance (`layout.eta` as base). On Workers, runtime code generation is disallowed, so `scripts/build.ts` precompiles templates to `src/views.generated.ts`. The same script records the build's `git describe` output in `src/build.generated.ts` for the page footer. Both are gitignored and regenerated by the `dev`/`deploy` scripts.
+**Templates:** `views/*.eta` - Eta templates with layout inheritance. `views/layouts/base.eta` is the HTML shell every page uses; `views/layouts/repo.eta` wraps it with the repository header, nav, and search box. Templates address each other from the views root (`/layouts/base.eta`) or as siblings (`./_tree`). On Workers, runtime code generation is disallowed, so `scripts/build.ts` precompiles templates to `src/views.generated.ts`. The same script records the build's `git describe` output in `src/build.generated.ts` for the page footer. Both are gitignored and regenerated by the `dev`/`deploy` scripts.
 
 **Static files:** `public/static/*`, served by Workers Static Assets.
 
diff --git a/cgithub/scripts/build.ts b/cgithub/scripts/build.ts
index 76d88a0..4908532 100644
--- a/cgithub/scripts/build.ts
+++ b/cgithub/scripts/build.ts
@@ -14,10 +14,22 @@ const root = path.join(import.meta.dirname, "..");
 const viewsDir = path.join(root, "views");
 const eta = new Eta({ views: viewsDir });
 
-const names = fs
-  .readdirSync(viewsDir)
-  .filter((name) => name.endsWith(".eta"))
-  .sort();
+// Names are the templates' paths under views/, e.g. "layouts/base.eta", which
+// is how the templates address each other (see src/worker.ts).
+function templateNames(dir: string, prefix = ""): string[] {
+  const names: string[] = [];
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    const name = prefix + entry.name;
+    if (entry.isDirectory()) {
+      names.push(...templateNames(path.join(dir, entry.name), `${name}/`));
+    } else if (entry.name.endsWith(".eta")) {
+      names.push(name);
+    }
+  }
+  return names.sort();
+}
+
+const names = templateNames(viewsDir);
 
 let out = `// @ts-nocheck
 // Generated by scripts/build.ts -- do not edit.
diff --git a/cgithub/src/app.ts b/cgithub/src/app.ts
index 2fa5832..a040aaa 100644
--- a/cgithub/src/app.ts
+++ b/cgithub/src/app.ts
@@ -39,7 +39,7 @@ export function createApp(eta: Eta) {
   const app = new Hono();
 
   app.use(async (c, next) => {
-    // Include render data for layout.eta.
+    // Include render data for views/layouts/base.eta.
     c.setRenderer((template, data) =>
       c.html(eta.render(template, { ...data, githubUrl: githubUrlFor(c), buildCommit })),
     );
diff --git a/cgithub/src/worker.ts b/cgithub/src/worker.ts
index 7bf9100..e59c690 100644
--- a/cgithub/src/worker.ts
+++ b/cgithub/src/worker.ts
@@ -9,8 +9,11 @@ import { views } from "./views.generated.ts";
 // cache: true, Eta serves them from the cache and never compiles.
 const eta = new Eta({ cache: true });
 
+// Templates name each other as siblings ("./_tree") or from the views root
+// ("/layouts/base.eta"); either way the name is the path under views/ that
+// scripts/build.ts keyed the template by.
 eta.resolvePath = (templatePath: string) => {
-  let name = templatePath.replace(/^\.\//, "");
+  let name = templatePath.replace(/^\.?\//, "");
   if (!name.endsWith(".eta")) name += ".eta";
   return name;
 };
diff --git a/cgithub/views/blob.eta b/cgithub/views/blob.eta
index 2014b14..9f6706e 100644
--- a/cgithub/views/blob.eta
+++ b/cgithub/views/blob.eta
@@ -1,4 +1,4 @@
-<% layout("./layout.eta"); it.searchType = "code" %>
+<% layout("/layouts/repo.eta"); it.searchType = "code" %>
 
 <%~ include("./_nav.eta", {...it, view: "blob"}) %>
 
diff --git a/cgithub/views/commits.eta b/cgithub/views/commits.eta
index c29693d..a80ef07 100644
--- a/cgithub/views/commits.eta
+++ b/cgithub/views/commits.eta
@@ -1,4 +1,4 @@
-<% layout("./layout.eta") %>
+<% layout("/layouts/repo.eta") %>
 
 <%~ include("./_nav.eta", {...it, view: "commits"}) %>
 
diff --git a/cgithub/views/issues.eta b/cgithub/views/issues.eta
index 646da46..754afb8 100644
--- a/cgithub/views/issues.eta
+++ b/cgithub/views/issues.eta
@@ -1,4 +1,4 @@
-<% layout("./layout"); it.searchType = "issues" %>
+<% layout("/layouts/repo.eta"); it.searchType = "issues" %>
 
 <table>
   <% for (const issue of it.issues) { %>
diff --git a/cgithub/views/layout.eta b/cgithub/views/layout.eta
deleted file mode 100644
index 37289dd..0000000
--- a/cgithub/views/layout.eta
+++ /dev/null
@@ -1,66 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title><%= it.repo.owner %>/<%= it.repo.name %> - <%= it.path || '/' %></title>
-  <link rel="stylesheet" href="/static/style.css">
-  <script src="/static/refs.js" defer></script>
-</head>
-<body>
-  <div class="box">
-    <div class="repo"><a href="/<%= it.repo.owner %>"><%= it.repo.owner %></a>/<a href="/<%= it.repo.owner %>/<%= it.repo.name %>"><%= it.repo.name %></a></div>
-    <pre><code>git clone https://github.com/<%= it.repo.owner %>/<%= it.repo.name %>.git
-git clone git@github.com:<%= it.repo.owner %>/<%= it.repo.name %>.git</code></pre>
-    <nav>
-      <a href="/<%= it.repo.owner %>/<%= it.repo.name %>">Code</a>
-      <a href="/<%= it.repo.owner %>/<%= it.repo.name %>/issues">Issues</a>
-      <a href="/<%= it.repo.owner %>/<%= it.repo.name %>/pulls">Pull requests</a>
-      <a href="/<%= it.repo.owner %>/<%= it.repo.name %>/releases">Releases</a>
-      <a href="/<%= it.repo.owner %>/<%= it.repo.name %>/wiki">Wiki</a>
-      <% if (it.branch) { %>
-        <a href="/<%= it.repo.owner %>/<%= it.repo.name %>/commits/<%= it.branch %><%= it.path && it.path !== '/' ? '/' + it.path : '' %>">Commits</a>
-      <% } %>
-    </nav>
-    <form action="/<%= it.repo.owner %>/<%= it.repo.name %>/search" method="get">
-      <input id="search-input" type="text" name="q" placeholder="Search…" value="<%= it.q ?? "" %>">
-      <select name="type">
-        <option value="issues" <%= it.searchType === "issues" ? "selected" : "" %>>Issues</option>
-        <option value="pullrequests" <%= it.searchType === "pullrequests" ? "selected" : "" %>>Pull requests</option>
-        <option value="code" <%= it.searchType === "code" || it.searchType == null ? "selected" : "" %>>Code</option>
-      </select>
-      <button type="submit">Search</button>
-    </form>
-  </div>
-
-  <%~ it.body %>
-
-  <footer>Generated by cgithub commit <code><%= it.buildCommit %></code> · <a href="<%= it.githubUrl %>" rel="noreferrer">View original</a></footer>
-
-  <script>
-    document.addEventListener("keydown", function(e) {
-      let shortcut = "";
-      if (e.ctrlKey || e.metaKey) shortcut += "C-";
-      if (e.altKey) shortcut += "A-";
-      if (e.shiftKey) shortcut += "S-";
-      shortcut += e.key;
-
-      if (shortcut === "Escape") {
-        document.activeElement.blur();
-        return;
-      }
-
-      if (["INPUT", "TEXTAREA", "SELECT"].includes(document.activeElement.tagName)) {
-        return;
-      }
-
-      if (shortcut === "/") {
-        e.preventDefault();
-        const input = document.getElementById('search-input');
-        input.select();
-        input.scrollIntoView({ block: "nearest" });
-      }
-    });
-  </script>
-</body>
-</html>
diff --git a/cgithub/views/layouts/base.eta b/cgithub/views/layouts/base.eta
new file mode 100644
index 0000000..fb644f5
--- /dev/null
+++ b/cgithub/views/layouts/base.eta
@@ -0,0 +1,17 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title><%= it.title %></title>
+  <link rel="stylesheet" href="/static/style.css">
+  <% for (const src of it.scripts ?? []) { %>
+    <script src="<%= src %>" defer></script>
+  <% } %>
+</head>
+<body>
+  <%~ it.body %>
+
+  <footer>Generated by cgithub commit <code><%= it.buildCommit %></code> · <a href="<%= it.githubUrl %>" rel="noreferrer">View original</a></footer>
+</body>
+</html>
diff --git a/cgithub/views/layouts/repo.eta b/cgithub/views/layouts/repo.eta
new file mode 100644
index 0000000..e4f7880
--- /dev/null
+++ b/cgithub/views/layouts/repo.eta
@@ -0,0 +1,59 @@
+<%
+layout("/layouts/base.eta", {
+  title: `${it.repo.owner}/${it.repo.name} - ${it.path || "/"}`,
+  scripts: ["/static/refs.js"],
+})
+%>
+
+<div class="box">
+  <div class="repo"><a href="/<%= it.repo.owner %>"><%= it.repo.owner %></a>/<a href="/<%= it.repo.owner %>/<%= it.repo.name %>"><%= it.repo.name %></a></div>
+  <pre><code>git clone https://github.com/<%= it.repo.owner %>/<%= it.repo.name %>.git
+git clone git@github.com:<%= it.repo.owner %>/<%= it.repo.name %>.git</code></pre>
+  <nav>
+    <a href="/<%= it.repo.owner %>/<%= it.repo.name %>">Code</a>
+    <a href="/<%= it.repo.owner %>/<%= it.repo.name %>/issues">Issues</a>
+    <a href="/<%= it.repo.owner %>/<%= it.repo.name %>/pulls">Pull requests</a>
+    <a href="/<%= it.repo.owner %>/<%= it.repo.name %>/releases">Releases</a>
+    <a href="/<%= it.repo.owner %>/<%= it.repo.name %>/wiki">Wiki</a>
+    <% if (it.branch) { %>
+      <a href="/<%= it.repo.owner %>/<%= it.repo.name %>/commits/<%= it.branch %><%= it.path && it.path !== '/' ? '/' + it.path : '' %>">Commits</a>
+    <% } %>
+  </nav>
+  <form action="/<%= it.repo.owner %>/<%= it.repo.name %>/search" method="get">
+    <input id="search-input" type="text" name="q" placeholder="Search…" value="<%= it.q ?? "" %>">
+    <select name="type">
+      <option value="issues" <%= it.searchType === "issues" ? "selected" : "" %>>Issues</option>
+      <option value="pullrequests" <%= it.searchType === "pullrequests" ? "selected" : "" %>>Pull requests</option>
+      <option value="code" <%= it.searchType === "code" || it.searchType == null ? "selected" : "" %>>Code</option>
+    </select>
+    <button type="submit">Search</button>
+  </form>
+</div>
+
+<%~ it.body %>
+
+<script>
+  document.addEventListener("keydown", function(e) {
+    let shortcut = "";
+    if (e.ctrlKey || e.metaKey) shortcut += "C-";
+    if (e.altKey) shortcut += "A-";
+    if (e.shiftKey) shortcut += "S-";
+    shortcut += e.key;
+
+    if (shortcut === "Escape") {
+      document.activeElement.blur();
+      return;
+    }
+
+    if (["INPUT", "TEXTAREA", "SELECT"].includes(document.activeElement.tagName)) {
+      return;
+    }
+
+    if (shortcut === "/") {
+      e.preventDefault();
+      const input = document.getElementById('search-input');
+      input.select();
+      input.scrollIntoView({ block: "nearest" });
+    }
+  });
+</script>
diff --git a/cgithub/views/owner.eta b/cgithub/views/owner.eta
index e5667fb..b3304fb 100644
--- a/cgithub/views/owner.eta
+++ b/cgithub/views/owner.eta
@@ -1,65 +1,54 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title><%= it.name ? `${it.name} (${it.login})` : it.login %></title>
-  <link rel="stylesheet" href="/static/style.css">
-</head>
-<body>
-  <div class="box">
-    <% if (it.avatarUrl) { %>
-      <img class="avatar" src="<%= it.avatarUrl %>" alt="" width="64" height="64">
-    <% } %>
-    <div class="repo"><%= it.name || it.login %></div>
-    <div><%= it.login %><%= it.type === "organization" ? " (organization)" : "" %></div>
-    <% if (it.location) { %>
-      <div><%= it.location %></div>
-    <% } %>
-    <% if (it.nav.length > 0) { %>
-      <nav>
-        <% for (const item of it.nav) { %>
-          <a href="<%= item.href %>"><%= item.text %></a>
-        <% } %>
-      </nav>
-    <% } %>
-  </div>
+<% layout("/layouts/base.eta", { title: it.name ? `${it.name} (${it.login})` : it.login }) %>
 
-  <% if (it.bio || it.links.length > 0 || it.followers || it.company) { %>
-    <div class="box repo-info">
-      <% if (it.bio) { %>
-        <div class="description"><%= it.bio %></div>
-      <% } %>
-      <% for (const link of it.links) { %>
-        <div class="detail"><img src="/static/icons/link.svg" alt="" class="icon"> <a href="<%= link.href %>" rel="noopener noreferrer"><%= link.text %></a></div>
-      <% } %>
-      <% if (it.followers) { %>
-        <div class="detail"><img src="/static/icons/eye.svg" alt="" class="icon"> <%= it.followers %> followers<%= it.following ? ` · ${it.following} following` : "" %></div>
-      <% } %>
-      <% if (it.company) { %>
-        <div class="detail"><%= it.company %></div>
-      <% } %>
-    </div>
+<div class="box">
+  <% if (it.avatarUrl) { %>
+    <img class="avatar" src="<%= it.avatarUrl %>" alt="" width="64" height="64">
   <% } %>
-
-  <% if (it.pinned.length > 0) { %>
-    <section>
-      <h2>Pinned</h2>
-      <% for (const repo of it.pinned) { %>
-        <%~ include("./_ownerRepo", { repo, login: it.login }) %>
-      <% } %>
-    </section>
+  <div class="repo"><%= it.name || it.login %></div>
+  <div><%= it.login %><%= it.type === "organization" ? " (organization)" : "" %></div>
+  <% if (it.location) { %>
+    <div><%= it.location %></div>
   <% } %>
-
-  <% if (it.repos.length > 0) { %>
-    <section>
-      <h2>Repositories</h2>
-      <% for (const repo of it.repos) { %>
-        <%~ include("./_ownerRepo", { repo, login: it.login }) %>
+  <% if (it.nav.length > 0) { %>
+    <nav>
+      <% for (const item of it.nav) { %>
+        <a href="<%= item.href %>"><%= item.text %></a>
       <% } %>
-    </section>
+    </nav>
   <% } %>
+</div>
+
+<% if (it.bio || it.links.length > 0 || it.followers || it.company) { %>
+  <div class="box repo-info">
+    <% if (it.bio) { %>
+      <div class="description"><%= it.bio %></div>
+    <% } %>
+    <% for (const link of it.links) { %>
+      <div class="detail"><img src="/static/icons/link.svg" alt="" class="icon"> <a href="<%= link.href %>" rel="noopener noreferrer"><%= link.text %></a></div>
+    <% } %>
+    <% if (it.followers) { %>
+      <div class="detail"><img src="/static/icons/eye.svg" alt="" class="icon"> <%= it.followers %> followers<%= it.following ? ` · ${it.following} following` : "" %></div>
+    <% } %>
+    <% if (it.company) { %>
+      <div class="detail"><%= it.company %></div>
+    <% } %>
+  </div>
+<% } %>
 
-  <footer>Generated by cgithub</footer>
-</body>
-</html>
+<% if (it.pinned.length > 0) { %>
+  <section>
+    <h2>Pinned</h2>
+    <% for (const repo of it.pinned) { %>
+      <%~ include("./_ownerRepo", { repo, login: it.login }) %>
+    <% } %>
+  </section>
+<% } %>
+
+<% if (it.repos.length > 0) { %>
+  <section>
+    <h2>Repositories</h2>
+    <% for (const repo of it.repos) { %>
+      <%~ include("./_ownerRepo", { repo, login: it.login }) %>
+    <% } %>
+  </section>
+<% } %>
diff --git a/cgithub/views/pulls.eta b/cgithub/views/pulls.eta
index 9ec5ca1..697f6b1 100644
--- a/cgithub/views/pulls.eta
+++ b/cgithub/views/pulls.eta
@@ -1,4 +1,4 @@
-<% layout("./layout"); it.searchType = "pullrequests" %>
+<% layout("/layouts/repo.eta"); it.searchType = "pullrequests" %>
 
 <table>
   <% for (const pull of it.pulls) { %>
diff --git a/cgithub/views/release.eta b/cgithub/views/release.eta
index 46dd5db..64cca35 100644
--- a/cgithub/views/release.eta
+++ b/cgithub/views/release.eta
@@ -1,3 +1,3 @@
-<% layout("./layout.eta") %>
+<% layout("/layouts/repo.eta") %>
 
 <%~ include("./_release.eta", { repo: it.repo, release: it.release, linkToDetail: false }) %>
diff --git a/cgithub/views/releases.eta b/cgithub/views/releases.eta
index 840908c..4ede28b 100644
--- a/cgithub/views/releases.eta
+++ b/cgithub/views/releases.eta
@@ -1,4 +1,4 @@
-<% layout("./layout.eta") %>
+<% layout("/layouts/repo.eta") %>
 
 <% for (const release of it.releases) { %>
   <%~ include("./_release.eta", { repo: it.repo, release, linkToDetail: true }) %>
diff --git a/cgithub/views/repo.eta b/cgithub/views/repo.eta
index 5dc6beb..60746df 100644
--- a/cgithub/views/repo.eta
+++ b/cgithub/views/repo.eta
@@ -1,4 +1,4 @@
-<% layout("./layout.eta") %>
+<% layout("/layouts/repo.eta") %>
 
 <% if (it.info) { %>
   <div class="box repo-info">
diff --git a/cgithub/views/tree.eta b/cgithub/views/tree.eta
index 41ded06..fabf5b9 100644
--- a/cgithub/views/tree.eta
+++ b/cgithub/views/tree.eta
@@ -1,3 +1,3 @@
-<% layout("./layout.eta"); it.searchType = "code" %>
+<% layout("/layouts/repo.eta"); it.searchType = "code" %>
 
 <%~ include("./_tree.eta", it) %>
diff --git a/cgithub/views/wiki.eta b/cgithub/views/wiki.eta
index d6047e1..781caff 100644
--- a/cgithub/views/wiki.eta
+++ b/cgithub/views/wiki.eta
@@ -1,4 +1,4 @@
-<% layout("./layout.eta"); it.path = "wiki/" + it.title %>
+<% layout("/layouts/repo.eta"); it.path = "wiki/" + it.title %>
 
 <%~ include("./_wikiNav.eta", it) %>
 
diff --git a/cgithub/views/wikiPages.eta b/cgithub/views/wikiPages.eta
index 58d6d21..eb90781 100644
--- a/cgithub/views/wikiPages.eta
+++ b/cgithub/views/wikiPages.eta
@@ -1,4 +1,4 @@
-<% layout("./layout.eta"); it.path = "wiki/_pages" %>
+<% layout("/layouts/repo.eta"); it.path = "wiki/_pages" %>
 
 <%~ include("./_wikiNav.eta", it) %>
 
-- 
cgit v1.3.1


From a7bc82cad42b7b8c4c8c52e1217f7f005b632e6d Mon Sep 17 00:00:00 2001
From: Joe Mou <dev@mou.fo>
Date: Wed, 9 Sep 2026 11:03:02 -0400
Subject: Serve GitHub's global search when it names one repository

/search?q=repo:owner/name+...&type=code matched the /:owner route and
rendered a profile page for an owner named "search", which GitHub 404s.
It is the URL GitHub's own search box produces, so it arrives whenever a
search is redirected here.

A /search route now takes it: when the query carries a repo: qualifier
and a type, it strips the qualifier and redirects to that repository's
search route, which already maps issues and pull requests to pages we
render and hands the rest to GitHub. Searches that name no single
repository -- bare queries, org:/user: scopes, a missing type -- keep
redirecting to github.com/search as they did before.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01GkGX6puS45xD5KzdV9tHEA
---
 cgithub/src/app.test.ts | 32 ++++++++++++++++++++++++++++++++
 cgithub/src/app.ts      | 19 +++++++++++++++++++
 2 files changed, 51 insertions(+)

(limited to 'cgithub/src/app.ts')

diff --git a/cgithub/src/app.test.ts b/cgithub/src/app.test.ts
index 274b2d5..8720a23 100644
--- a/cgithub/src/app.test.ts
+++ b/cgithub/src/app.test.ts
@@ -358,6 +358,38 @@ describe("wiki", () => {
   });
 });
 
+describe("global search", () => {
+  it("should keep the rest of the query around the qualifier", async () => {
+    const res = await app.request(
+      "http://cgithub.example/search?q=" +
+        encodeURIComponent("is:issue repo:actions/deploy-pages label:bug") +
+        "&type=issues",
+    );
+
+    assert.strictEqual(
+      res.headers.get("location"),
+      "/actions/deploy-pages/search?q=is%3Aissue+label%3Abug&type=issues",
+    );
+  });
+
+  it("should redirect searches it cannot scope to a repository", async () => {
+    for (const url of [
+      "http://cgithub.example/search?q=dms&type=code",
+      // An owner-wide search is not a single repository.
+      "http://cgithub.example/search?q=" +
+        encodeURIComponent("org:nix-community dms") +
+        "&type=code",
+      // Without a type there is no search to hand over.
+      "http://cgithub.example/search?q=" + encodeURIComponent("repo:actions/deploy-pages dms"),
+    ]) {
+      const res = await app.request(url);
+
+      assert.strictEqual(res.status, 200, url);
+      assert.match(await res.text(), /url=https:\/\/github.com\/search\?/);
+    }
+  });
+});
+
 describe("redirects to GitHub", () => {
   // An HTTP redirect would be caught by the extension's declarativeNetRequest
   // rules and bounced straight back here.
diff --git a/cgithub/src/app.ts b/cgithub/src/app.ts
index a040aaa..7e5e9e8 100644
--- a/cgithub/src/app.ts
+++ b/cgithub/src/app.ts
@@ -95,6 +95,25 @@ export function createApp(eta: Eta) {
     return c.render("home.eta");
   });
 
+  // GitHub's global search, which we only serve when it is scoped to a single
+  // repository: strip the qualifier and let that repository's search route
+  // decide what to do with the rest.
+  app.get("/search", async (c) => {
+    const q = c.req.query("q") ?? "";
+    const type = c.req.query("type");
+
+    const repoQualifier = /(?:^|\s)repo:([^/\s]+)\/([^/\s]+)(?=\s|$)/.exec(q);
+    if (type && repoQualifier) {
+      const [qualifier, owner, repo] = repoQualifier;
+      const rest =
+        q.slice(0, repoQualifier.index) + q.slice(repoQualifier.index + qualifier.length);
+      const params = new URLSearchParams({ q: rest.trim(), type });
+      return c.redirect(`/${owner}/${repo}/search?${params}`);
+    }
+
+    return redirectToGitHub(c);
+  });
+
   app.get("/:owner", async (c) => {
     const { owner } = c.req.param();
     return c.render("owner.eta", await getGitHubOwner(owner));
-- 
cgit v1.3.1


From 198f2a07f68a348dc0823b2bde3bec541e06db01 Mon Sep 17 00:00:00 2001
From: Joe Mou <dev@mou.fo>
Date: Thu, 10 Sep 2026 00:53:48 -0400
Subject: Redirect /notifications instead of scraping it as an owner

A signed-out request for github.com/notifications is bounced to a login
page, so the owner route followed that redirect and left the visitor on
/login. Hand the path over to GitHub before it reaches the route.
---
 cgithub/README.md       | 4 ++--
 cgithub/src/app.test.ts | 7 +++++++
 cgithub/src/app.ts      | 5 +++++
 3 files changed, 14 insertions(+), 2 deletions(-)

(limited to 'cgithub/src/app.ts')

diff --git a/cgithub/README.md b/cgithub/README.md
index 533c88f..45c94cf 100644
--- a/cgithub/README.md
+++ b/cgithub/README.md
@@ -28,8 +28,8 @@ Not implemented:
 - Actions, checks, projects, packages, discussions, and gists
 - Profile tabs other than the overview (repositories, projects, packages,
   people, sponsoring)
-- Anything requiring an account: signing in, starring, commenting, editing, or
-  any other write action
+- Anything requiring an account: signing in, notifications, starring,
+  commenting, editing, or any other write action
 - Private repositories
 
 ## Browser extension redirects
diff --git a/cgithub/src/app.test.ts b/cgithub/src/app.test.ts
index 8720a23..c028e1b 100644
--- a/cgithub/src/app.test.ts
+++ b/cgithub/src/app.test.ts
@@ -441,6 +441,13 @@ describe("redirects to GitHub", () => {
     );
   });
 
+  it("should redirect notifications without scraping them as a profile", async () => {
+    const res = await app.request("http://cgithub.example/notifications?query=is%3Aunread");
+
+    assert.strictEqual(res.status, 200);
+    assert.match(await res.text(), /url=https:\/\/github.com\/notifications\?query=is%3Aunread"/);
+  });
+
   it("should redirect raw file requests to raw.githubusercontent.com", async () => {
     const res = await app.request("http://cgithub.example/actions/deploy-pages/raw/main/README.md");
 
diff --git a/cgithub/src/app.ts b/cgithub/src/app.ts
index 7e5e9e8..0b9a7e6 100644
--- a/cgithub/src/app.ts
+++ b/cgithub/src/app.ts
@@ -95,6 +95,11 @@ export function createApp(eta: Eta) {
     return c.render("home.eta");
   });
 
+  // Exclusion that immediately redirects to GitHub.
+  app.get("/notifications", async (c) => {
+    return redirectToGitHub(c);
+  });
+
   // GitHub's global search, which we only serve when it is scoped to a single
   // repository: strip the qualifier and let that repository's search route
   // decide what to do with the rest.
-- 
cgit v1.3.1