From 83097c8305532c6c48355219cadca6325d9989e3 Mon Sep 17 00:00:00 2001
From: Baptiste LAFOURCADE <baptiste.lafourcade@gmail.com>
Date: Thu, 13 Aug 2026 23:40:53 +0200
Subject: [PATCH 1/4] ci: render the star history chart in the repo's own CI

GitHub restricted the stargazers API to a repository's own admins and
collaborators on June 30 2026, so the third-party chart the README embeds
now returns a placeholder telling readers the data is unavailable.

The repository can still read its own stargazers, so the chart is rendered
here from that data and published on the star-history orphan branch. No
credential leaves the repository, and the renderer is deterministic, so a
run that finds no new star produces no commit.

The push trigger is temporary: schedule and workflow_dispatch only fire from
the default branch, so it is the only way to exercise the workflow before the
merge. It is removed later in this same pull request.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
---
 .github/workflows/star-history.yml |  68 +++++++++++++++
 scripts/generate-star-history.mjs  | 135 +++++++++++++++++++++++++++++
 2 files changed, 203 insertions(+)
 create mode 100644 .github/workflows/star-history.yml
 create mode 100644 scripts/generate-star-history.mjs

diff --git a/.github/workflows/star-history.yml b/.github/workflows/star-history.yml
new file mode 100644
index 00000000..ff5b9033
--- /dev/null
+++ b/.github/workflows/star-history.yml
@@ -0,0 +1,68 @@
+name: Star history
+
+# Regenerates the star history chart the README embeds. GitHub restricted the
+# stargazers API to a repository's own admins and collaborators on June 30 2026,
+# so no third-party service can draw this chart any more — only the repository
+# itself can, with its own token.
+#
+# The SVG is published on the `star-history` orphan branch rather than committed
+# to main: main requires a pull request, and a data-only branch keeps generated
+# bytes out of the source history while staying servable over raw.githubusercontent.
+
+on:
+  schedule:
+    - cron: "0 5 * * 1" # Mondays 05:00 UTC
+  workflow_dispatch:
+  push:
+    branches: [blafourcade/fix-stars] # TEMPORARY: schedule and dispatch only fire from the default branch, so this proves the workflow before the merge. Removed in this same PR.
+
+concurrency:
+  group: star-history
+  cancel-in-progress: false
+
+permissions:
+  contents: write
+
+jobs:
+  star-history:
+    name: Render the chart and publish it
+    runs-on: ubuntu-latest
+    env:
+      BRANCH: star-history
+      FILE: star-history.svg
+    steps:
+      - name: Checkout
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+
+      - name: Setup Node
+        uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+        with:
+          node-version: "22"
+
+      - name: Render the chart
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: node scripts/generate-star-history.mjs > "$FILE"
+
+      - name: Publish it to the ${{ env.BRANCH }} branch
+        run: |
+          set -euo pipefail
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+
+          parent=""
+          if git fetch --depth=1 origin "$BRANCH" 2>/dev/null; then
+            parent=$(git rev-parse FETCH_HEAD)
+          fi
+
+          blob=$(git hash-object -w "$FILE")
+          tree=$(printf '100644 blob %s\t%s\n' "$blob" "$FILE" | git mktree)
+
+          # The renderer is deterministic, so an identical tree means no new star.
+          if [ -n "$parent" ] && [ "$(git rev-parse "$parent^{tree}")" = "$tree" ]; then
+            echo "Star history unchanged."
+            exit 0
+          fi
+
+          commit=$(git commit-tree "$tree" ${parent:+-p "$parent"} -m "chore(ci): refresh star history chart")
+          git push origin "$commit:refs/heads/$BRANCH"
diff --git a/scripts/generate-star-history.mjs b/scripts/generate-star-history.mjs
new file mode 100644
index 00000000..0764b051
--- /dev/null
+++ b/scripts/generate-star-history.mjs
@@ -0,0 +1,135 @@
+#!/usr/bin/env node
+// Renders the repository's star history as an SVG on stdout, from the GitHub
+// stargazers API. Since June 30 2026 that API only answers a repository's own
+// admins and collaborators, which killed the third-party chart services the
+// README used to embed. Running it here, with the repository's own credentials,
+// is the only way left to keep a live chart.
+//
+//   GH_TOKEN=$(gh auth token) node scripts/generate-star-history.mjs > star-history.svg
+//
+// The output is deterministic: identical star data yields identical bytes, so a
+// scheduled run that finds no new star produces no commit. Nothing renders the
+// current date, and no <style> or <script> is emitted, because GitHub strips
+// both when it serves an SVG into a README.
+
+const REPO = process.env.GITHUB_REPOSITORY ?? "ai-driven-dev/framework";
+const TOKEN = process.env.GH_TOKEN ?? process.env.GITHUB_TOKEN;
+
+const WIDTH = 800;
+const HEIGHT = 400;
+const MARGIN = { top: 28, right: 24, bottom: 40, left: 60 };
+const MAX_POINTS = 200;
+const X_TICKS = 5;
+const Y_TICKS = 4;
+
+const AXIS_COLOR = "#8b949e";
+const GRID_COLOR = "#8b949e40";
+const LINE_COLOR = "#e3b341";
+const AREA_COLOR = "#e3b34126";
+
+const PLOT_WIDTH = WIDTH - MARGIN.left - MARGIN.right;
+const PLOT_HEIGHT = HEIGHT - MARGIN.top - MARGIN.bottom;
+
+async function fetchStarDates() {
+  const dates = [];
+  let url = `https://api.github.com/repos/${REPO}/stargazers?per_page=100`;
+
+  while (url) {
+    const response = await fetch(url, {
+      headers: {
+        accept: "application/vnd.github.star+json",
+        "x-github-api-version": "2022-11-28",
+        ...(TOKEN ? { authorization: `Bearer ${TOKEN}` } : {}),
+      },
+    });
+
+    if (!response.ok) {
+      throw new Error(`GET ${url} -> ${response.status} ${response.statusText}`);
+    }
+
+    for (const { starred_at } of await response.json()) {
+      if (starred_at) dates.push(Date.parse(starred_at));
+    }
+
+    url = nextPage(response.headers.get("link"));
+  }
+
+  return dates.sort((a, b) => a - b);
+}
+
+function nextPage(linkHeader) {
+  return linkHeader?.match(/<([^>]+)>;\s*rel="next"/)?.[1] ?? null;
+}
+
+// A cumulative curve of N stars is N points; every chart is 800px wide. Keeping
+// one point per pixel at most holds the file small without any visible loss.
+function sample(dates) {
+  if (dates.length <= MAX_POINTS) {
+    return dates.map((date, index) => ({ date, count: index + 1 }));
+  }
+
+  const step = (dates.length - 1) / (MAX_POINTS - 1);
+  return Array.from({ length: MAX_POINTS }, (_, i) => {
+    const index = Math.round(i * step);
+    return { date: dates[index], count: index + 1 };
+  });
+}
+
+// Rounds a tick step up to the next 1, 2 or 5 x 10^k, so labels read as round
+// numbers instead of arbitrary fractions of the total.
+function niceStep(rawStep) {
+  const magnitude = 10 ** Math.floor(Math.log10(rawStep));
+  const normalized = rawStep / magnitude;
+  const rounded = normalized <= 1 ? 1 : normalized <= 2 ? 2 : normalized <= 5 ? 5 : 10;
+  return rounded * magnitude;
+}
+
+function buildSvg(points) {
+  const firstDate = points[0].date;
+  const lastDate = points[points.length - 1].date;
+  const total = points[points.length - 1].count;
+  const span = Math.max(lastDate - firstDate, 1);
+
+  const x = (date) => MARGIN.left + ((date - firstDate) / span) * PLOT_WIDTH;
+  const y = (count) => MARGIN.top + PLOT_HEIGHT - (count / total) * PLOT_HEIGHT;
+  const round = (value) => Math.round(value * 10) / 10;
+
+  const curve = points.map((p) => `${round(x(p.date))},${round(y(p.count))}`).join(" ");
+  const baseline = MARGIN.top + PLOT_HEIGHT;
+
+  const yStep = niceStep(total / Y_TICKS);
+  const yTicks = [];
+  for (let count = 0; count <= total; count += yStep) yTicks.push(count);
+
+  const xTicks = Array.from({ length: X_TICKS }, (_, i) => firstDate + (span * i) / (X_TICKS - 1));
+
+  return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${WIDTH} ${HEIGHT}" width="${WIDTH}" height="${HEIGHT}" font-family="sans-serif" font-size="12">
+<title>Star history of ${REPO}: ${total} stars</title>
+${yTicks
+  .map(
+    (count) =>
+      `<line x1="${MARGIN.left}" y1="${round(y(count))}" x2="${MARGIN.left + PLOT_WIDTH}" y2="${round(y(count))}" stroke="${GRID_COLOR}" />` +
+      `<text x="${MARGIN.left - 10}" y="${round(y(count)) + 4}" fill="${AXIS_COLOR}" text-anchor="end">${count}</text>`,
+  )
+  .join("\n")}
+${xTicks
+  .map((date, index) => {
+    // The edge labels are anchored inwards, otherwise half of each sits outside the viewBox.
+    const anchor = index === 0 ? "start" : index === xTicks.length - 1 ? "end" : "middle";
+    return `<text x="${round(x(date))}" y="${baseline + 20}" fill="${AXIS_COLOR}" text-anchor="${anchor}">${new Date(date).toISOString().slice(0, 7)}</text>`;
+  })
+  .join("\n")}
+<polygon points="${round(MARGIN.left)},${baseline} ${curve} ${round(x(lastDate))},${baseline}" fill="${AREA_COLOR}" />
+<polyline points="${curve}" fill="none" stroke="${LINE_COLOR}" stroke-width="2" stroke-linejoin="round" />
+<text x="${MARGIN.left}" y="${MARGIN.top - 12}" fill="${AXIS_COLOR}">${REPO} — ${total} stars</text>
+</svg>
+`;
+}
+
+const dates = await fetchStarDates();
+
+if (dates.length < 2) {
+  throw new Error(`${REPO} has ${dates.length} dated star(s); nothing to chart.`);
+}
+
+process.stdout.write(buildSvg(sample(dates)));

From 7afabacb0eb8ebc62031a256911910515ed384d2 Mon Sep 17 00:00:00 2001
From: Baptiste LAFOURCADE <baptiste.lafourcade@gmail.com>
Date: Thu, 13 Aug 2026 23:43:58 +0200
Subject: [PATCH 2/4] docs: point the star chart at the self-hosted SVG

api.star-history.com now answers with a placeholder image reading "GitHub
restricted access to star data", so the README advertised a dead chart. It
now embeds the SVG this repository renders itself, and the image links to
the stargazers page.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 74777425..d08a2c21 100644
--- a/README.md
+++ b/README.md
@@ -326,7 +326,7 @@ Free and open-source (MIT). If it saves you time, [a ⭐](https://github.com/ai-
 
 <div align="center">
 
-<img src="https://api.star-history.com/svg?repos=ai-driven-dev/framework&type=Date" alt="Star History Chart" width="500" />
+<a href="https://github.com/ai-driven-dev/framework/stargazers"><img src="https://raw.githubusercontent.com/ai-driven-dev/framework/star-history/star-history.svg" alt="Star History Chart" width="500" /></a>
 
 Made with care in France 🇫🇷 · ← [AIDD organisation](https://github.com/ai-driven-dev)
 

From d9c3612aea133b4ba240d265e299bf166ff3f9ff Mon Sep 17 00:00:00 2001
From: Baptiste LAFOURCADE <baptiste.lafourcade@gmail.com>
Date: Thu, 13 Aug 2026 23:44:51 +0200
Subject: [PATCH 3/4] ci: drop the temporary trigger from the star history
 workflow

It existed to run the workflow from this branch, since schedule and
workflow_dispatch only fire from the default branch. Runs 31746866236 and
31746963019 proved both paths: the first published the chart, the second
found no new star and committed nothing.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
---
 .github/workflows/star-history.yml | 2 --
 1 file changed, 2 deletions(-)

diff --git a/.github/workflows/star-history.yml b/.github/workflows/star-history.yml
index ff5b9033..0184d883 100644
--- a/.github/workflows/star-history.yml
+++ b/.github/workflows/star-history.yml
@@ -13,8 +13,6 @@ on:
   schedule:
     - cron: "0 5 * * 1" # Mondays 05:00 UTC
   workflow_dispatch:
-  push:
-    branches: [blafourcade/fix-stars] # TEMPORARY: schedule and dispatch only fire from the default branch, so this proves the workflow before the merge. Removed in this same PR.
 
 concurrency:
   group: star-history

From ece664c358e166b1ac44139d2169d4442de8d89b Mon Sep 17 00:00:00 2001
From: Baptiste LAFOURCADE <baptiste.lafourcade@gmail.com>
Date: Thu, 13 Aug 2026 23:47:10 +0200
Subject: [PATCH 4/4] style(ci): drop the em-dash from the star chart caption

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
---
 scripts/generate-star-history.mjs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/scripts/generate-star-history.mjs b/scripts/generate-star-history.mjs
index 0764b051..a97ba2d1 100644
--- a/scripts/generate-star-history.mjs
+++ b/scripts/generate-star-history.mjs
@@ -121,7 +121,7 @@ ${xTicks
   .join("\n")}
 <polygon points="${round(MARGIN.left)},${baseline} ${curve} ${round(x(lastDate))},${baseline}" fill="${AREA_COLOR}" />
 <polyline points="${curve}" fill="none" stroke="${LINE_COLOR}" stroke-width="2" stroke-linejoin="round" />
-<text x="${MARGIN.left}" y="${MARGIN.top - 12}" fill="${AXIS_COLOR}">${REPO} — ${total} stars</text>
+<text x="${MARGIN.left}" y="${MARGIN.top - 12}" fill="${AXIS_COLOR}">${REPO} · ${total} stars</text>
 </svg>
 `;
 }