an open-source alternative to the dots, bots and muses of the world, run an office of claude code/codex like agents on your laptop, sandboxes or anywhere, uses your existing subscriptions
HTML agent-harnessagent-orchestrationagentsai-agentsautonomous-agentsclaude-codecodexcoding-agentsdesktop-appdeveloper-toolselectrongemini-cliharnessharness-engineeringlocal-firstmemorymulti-agentopencodeorchestrationtypescript
docs: re-land CONTRIBUTORS.md, which never reached main (#444)
Chaitanya Giri3f53763fa4b8
diff --git a/.github/CODEOWNERS b/.github/CODEOWNERSindex 9df484f9..b7500692 100644--- a/.github/CODEOWNERS+++ b/.github/CODEOWNERS@@ -19,3 +19,7 @@# Security and privacy surface./SECURITY.md @chaitanyagiri/TELEMETRY.md @chaitanyagiri++# Public credit for contributors. Adding a name here is a public claim about someone's work.+/.github/contributors-extra.json @chaitanyagiri+/CONTRIBUTORS.md @chaitanyagiridiff --git a/.github/contributors-extra.json b/.github/contributors-extra.jsonnew file mode 100644index 00000000..e4a98727--- /dev/null+++ b/.github/contributors-extra.json@@ -0,0 +1,47 @@+{+ "_readme": [+ "Contributions that are in main but whose pull request does not carry GitHub's merged badge.",+ "On 0.4.6 release night the pull requests were closed before the release branch merged into",+ "main, so GitHub recorded them as closed. GitHub will not let that be undone. The full",+ "explanation is in discussion #353. These people contributed and the generator would miss",+ "them, so they are listed here by pull request number.",+ "",+ "Only the pull request number and the commits are recorded here. The contributor's identity is",+ "read from the GitHub API at generation time, so a login rename or an avatar change follows",+ "automatically and nobody's name can go stale or be typed wrong.",+ "",+ "Every commit listed below was verified to be an ancestor of origin/main before it was added.",+ "Adding an entry here credits a person publicly. It is covered by CODEOWNERS for that reason."+ ],+ "landed_without_merged_badge": [+ { "pr": 156, "commits": ["ed8bc84f"] },+ { "pr": 205, "commits": ["9550dd74"] },+ { "pr": 225, "commits": ["7b570c2c"] },+ { "pr": 242, "commits": ["b01770e4"] },+ { "pr": 243, "commits": ["9edf34ea"] },+ { "pr": 248, "commits": ["1155c344"] },+ { "pr": 270, "commits": ["ee806756"] },+ { "pr": 271, "commits": ["6446a8d8"] },+ { "pr": 282, "commits": ["c461fe1a"] },+ { "pr": 284, "commits": ["268ec1b8"] },+ { "pr": 286, "commits": ["94a03bb8"] },+ { "pr": 310, "commits": ["4cdd0393"] },+ { "pr": 317, "commits": ["2b96d5d0"] },+ { "pr": 323, "commits": ["e6c936ac"] },+ {+ "pr": 213,+ "commits": ["59d721ed", "6f7ffb89"],+ "note": "Arabic and RTL support. The files were carried over byte for byte and committed under a maintainer account, so these commits do not even carry their name."+ },+ {+ "pr": 168,+ "commits": ["9bb060dd"],+ "note": "One of the two commits on the branch is in main."+ },+ {+ "pr": 172,+ "commits": ["7b187d2e", "d41eee90"],+ "note": "Two of the three commits on the branch are in main. The pull request is still open and the third commit is still to be taken."+ }+ ]+}diff --git a/.github/workflows/contributors.yml b/.github/workflows/contributors.ymlnew file mode 100644index 00000000..29f4c004--- /dev/null+++ b/.github/workflows/contributors.yml@@ -0,0 +1,53 @@+name: Update contributors++# Anyone with a merged pull request is a contributor, and this keeps the list+# honest without anyone having to remember. It regenerates from the merged PRs+# themselves rather than from commit metadata, because GitHub's own contributors+# graph keys on the commit author email and silently drops anyone whose git+# email is not attached to their GitHub account.+on:+ pull_request_target:+ types: [closed]+ branches: [main]+ schedule:+ - cron: '23 5 * * 1'+ workflow_dispatch:++permissions:+ contents: write++concurrency:+ group: contributors+ cancel-in-progress: false++jobs:+ update:+ # Only when something actually merged.+ if: github.event_name != 'pull_request_target' || github.event.pull_request.merged == true+ runs-on: ubuntu-latest+ timeout-minutes: 10+ steps:+ - uses: actions/checkout@v4+ with:+ ref: main+ - uses: actions/setup-node@v4+ with:+ node-version: 20++ - name: Regenerate CONTRIBUTORS.md+ env:+ GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}+ run: node scripts/generate-contributors.mjs++ - name: Commit if it changed+ run: |+ set -euo pipefail+ if git diff --quiet -- CONTRIBUTORS.md; then+ echo "No change."+ exit 0+ fi+ git config user.name "github-actions[bot]"+ git config user.email "41898282+github-actions[bot]@users.noreply.github.com"+ git add CONTRIBUTORS.md+ git commit -m "docs: update contributors [skip ci]"+ git pushdiff --git a/CONTRIBUTORS.md b/CONTRIBUTORS.mdnew file mode 100644index 00000000..7aa39608--- /dev/null+++ b/CONTRIBUTORS.md@@ -0,0 +1,104 @@+# Contributors++Everyone on this list has code in Munder Difflin. If that is you, this file is yours to point at.++It is generated from the pull requests themselves rather than from commit metadata, so nobody is+dropped because their git email does not happen to match their GitHub account. It regenerates+whenever a pull request merges, so you appear without having to ask.++**38 people** have contributed so far.++<a href="https://github.com/chaitanyagiri/munder-difflin/graphs/contributors">+ <img src="https://contrib.rocks/image?repo=chaitanyagiri/munder-difflin" alt="Contributor avatars">+</a>++| Contributor | Contributions | First | Most recent |+|---|---:|---|---|+| [@chaitanyagiri](https://github.com/chaitanyagiri) | 47 | 2026-06-10 | 2026-09-02 |+| [@Gulum](https://github.com/Gulum) | 20 | 2026-06-06 | 2026-06-10 |+| [@gts-47](https://github.com/gts-47) | 11 | 2026-06-13 | 2026-08-22 |+| [@qschmick](https://github.com/qschmick) | 5 | 2026-07-31 | 2026-08-06 |+| [@gpechieu](https://github.com/gpechieu) † | 5 | 2026-08-22 | 2026-08-27 |+| [@pdurlej](https://github.com/pdurlej) | 3 | 2026-06-08 | 2026-06-10 |+| [@TTAWDTT](https://github.com/TTAWDTT) | 3 | 2026-08-22 | 2026-08-22 |+| [@jjc6676](https://github.com/jjc6676) | 2 | 2026-06-08 | 2026-06-14 |+| [@BUGHUNTER-SACHIN](https://github.com/BUGHUNTER-SACHIN) † | 2 | 2026-08-22 | 2026-08-27 |+| [@hyperstream-pro](https://github.com/hyperstream-pro) | 2 | 2026-08-22 | 2026-08-22 |+| [@GBurchell27](https://github.com/GBurchell27) | 2 | 2026-08-22 | 2026-08-22 |+| [@HundredBillion](https://github.com/HundredBillion) † | 2 | 2026-08-27 | 2026-08-27 |+| [@aaroncoville](https://github.com/aaroncoville) † | 2 | 2026-08-27 | 2026-08-27 |+| [@anxkhn](https://github.com/anxkhn) | 1 | 2026-07-02 | 2026-07-02 |+| [@baziyer](https://github.com/baziyer) | 1 | 2026-08-18 | 2026-08-18 |+| [@HaningZS](https://github.com/HaningZS) † | 1 | 2026-08-18 | 2026-08-18 |+| [@amey-op](https://github.com/amey-op) | 1 | 2026-08-22 | 2026-08-22 |+| [@bluepanda999](https://github.com/bluepanda999) | 1 | 2026-08-22 | 2026-08-22 |+| [@FenjuFu](https://github.com/FenjuFu) | 1 | 2026-08-22 | 2026-08-22 |+| [@kdahal7](https://github.com/kdahal7) | 1 | 2026-08-22 | 2026-08-22 |+| [@KrushanPatel](https://github.com/KrushanPatel) | 1 | 2026-08-22 | 2026-08-22 |+| [@lifelmy](https://github.com/lifelmy) | 1 | 2026-08-22 | 2026-08-22 |+| [@pontusm](https://github.com/pontusm) | 1 | 2026-08-22 | 2026-08-22 |+| [@rajpreetcodes](https://github.com/rajpreetcodes) | 1 | 2026-08-22 | 2026-08-22 |+| [@rekcilyssup](https://github.com/rekcilyssup) | 1 | 2026-08-22 | 2026-08-22 |+| [@swarnendu19](https://github.com/swarnendu19) | 1 | 2026-08-22 | 2026-08-22 |+| [@tsurutanmen](https://github.com/tsurutanmen) | 1 | 2026-08-22 | 2026-08-22 |+| [@scy73](https://github.com/scy73) | 1 | 2026-08-22 | 2026-08-22 |+| [@lukatao](https://github.com/lukatao) † | 1 | 2026-08-27 | 2026-08-27 |+| [@jhinzzz](https://github.com/jhinzzz) † | 1 | 2026-08-27 | 2026-08-27 |+| [@raifemre](https://github.com/raifemre) † | 1 | 2026-08-27 | 2026-08-27 |+| [@L422Y](https://github.com/L422Y) † | 1 | 2026-08-27 | 2026-08-27 |+| [@djbiz](https://github.com/djbiz) † | 1 | 2026-08-27 | 2026-08-27 |+| [@HsienW](https://github.com/HsienW) † | 1 | 2026-08-27 | 2026-08-27 |+| [@savvaskoualis](https://github.com/savvaskoualis) † | 1 | 2026-08-27 | 2026-08-27 |+| [@LavaDMan](https://github.com/LavaDMan) † | 1 | 2026-08-27 | 2026-08-27 |+| [@abo123v-glitch](https://github.com/abo123v-glitch) † | 1 | 2026-08-27 | 2026-08-27 |+| [@Maev4l](https://github.com/Maev4l) † | 1 | 2026-08-27 | 2026-08-27 |++_131 pull requests from 38 people._++## † Contributions that never got the merged badge++17 pull requests below are in main and their authors are contributors, but GitHub+shows them as closed rather than merged. On release night the pull requests were closed before the+release branch merged into main, so at the moment they closed, main did not contain their commits+yet. GitHub records the badge at that instant and will not let it be changed afterwards. It was our+sequencing mistake and it is not recoverable, so the record lives here instead. The full account is+in [discussion #353](https://github.com/chaitanyagiri/munder-difflin/discussions/353).++Every commit listed here was checked to be in `main` before it was added.++| Pull request | Contributor | In main |+|---|---|---|+| [#156](https://github.com/chaitanyagiri/munder-difflin/pull/156) | [@gpechieu](https://github.com/gpechieu) | [`ed8bc84f`](https://github.com/chaitanyagiri/munder-difflin/commit/ed8bc84f) |+| [#168](https://github.com/chaitanyagiri/munder-difflin/pull/168) | [@Maev4l](https://github.com/Maev4l) | [`9bb060dd`](https://github.com/chaitanyagiri/munder-difflin/commit/9bb060dd) |+| [#172](https://github.com/chaitanyagiri/munder-difflin/pull/172) | [@HaningZS](https://github.com/HaningZS) | [`7b187d2e`](https://github.com/chaitanyagiri/munder-difflin/commit/7b187d2e), [`d41eee90`](https://github.com/chaitanyagiri/munder-difflin/commit/d41eee90) |+| [#205](https://github.com/chaitanyagiri/munder-difflin/pull/205) | [@lukatao](https://github.com/lukatao) | [`9550dd74`](https://github.com/chaitanyagiri/munder-difflin/commit/9550dd74) |+| [#213](https://github.com/chaitanyagiri/munder-difflin/pull/213) | [@abo123v-glitch](https://github.com/abo123v-glitch) | [`59d721ed`](https://github.com/chaitanyagiri/munder-difflin/commit/59d721ed), [`6f7ffb89`](https://github.com/chaitanyagiri/munder-difflin/commit/6f7ffb89) |+| [#225](https://github.com/chaitanyagiri/munder-difflin/pull/225) | [@jhinzzz](https://github.com/jhinzzz) | [`7b570c2c`](https://github.com/chaitanyagiri/munder-difflin/commit/7b570c2c) |+| [#242](https://github.com/chaitanyagiri/munder-difflin/pull/242) | [@raifemre](https://github.com/raifemre) | [`b01770e4`](https://github.com/chaitanyagiri/munder-difflin/commit/b01770e4) |+| [#243](https://github.com/chaitanyagiri/munder-difflin/pull/243) | [@L422Y](https://github.com/L422Y) | [`9edf34ea`](https://github.com/chaitanyagiri/munder-difflin/commit/9edf34ea) |+| [#248](https://github.com/chaitanyagiri/munder-difflin/pull/248) | [@djbiz](https://github.com/djbiz) | [`1155c344`](https://github.com/chaitanyagiri/munder-difflin/commit/1155c344) |+| [#270](https://github.com/chaitanyagiri/munder-difflin/pull/270) | [@BUGHUNTER-SACHIN](https://github.com/BUGHUNTER-SACHIN) | [`ee806756`](https://github.com/chaitanyagiri/munder-difflin/commit/ee806756) |+| [#271](https://github.com/chaitanyagiri/munder-difflin/pull/271) | [@HsienW](https://github.com/HsienW) | [`6446a8d8`](https://github.com/chaitanyagiri/munder-difflin/commit/6446a8d8) |+| [#282](https://github.com/chaitanyagiri/munder-difflin/pull/282) | [@savvaskoualis](https://github.com/savvaskoualis) | [`c461fe1a`](https://github.com/chaitanyagiri/munder-difflin/commit/c461fe1a) |+| [#284](https://github.com/chaitanyagiri/munder-difflin/pull/284) | [@HundredBillion](https://github.com/HundredBillion) | [`268ec1b8`](https://github.com/chaitanyagiri/munder-difflin/commit/268ec1b8) |+| [#286](https://github.com/chaitanyagiri/munder-difflin/pull/286) | [@HundredBillion](https://github.com/HundredBillion) | [`94a03bb8`](https://github.com/chaitanyagiri/munder-difflin/commit/94a03bb8) |+| [#310](https://github.com/chaitanyagiri/munder-difflin/pull/310) | [@LavaDMan](https://github.com/LavaDMan) | [`4cdd0393`](https://github.com/chaitanyagiri/munder-difflin/commit/4cdd0393) |+| [#317](https://github.com/chaitanyagiri/munder-difflin/pull/317) | [@aaroncoville](https://github.com/aaroncoville) | [`2b96d5d0`](https://github.com/chaitanyagiri/munder-difflin/commit/2b96d5d0) |+| [#323](https://github.com/chaitanyagiri/munder-difflin/pull/323) | [@aaroncoville](https://github.com/aaroncoville) | [`e6c936ac`](https://github.com/chaitanyagiri/munder-difflin/commit/e6c936ac) |++**#168** One of the two commits on the branch is in main.++**#172** Two of the three commits on the branch are in main. The pull request is still open and the third commit is still to be taken.++**#213** Arabic and RTL support. The files were carried over byte for byte and committed under a maintainer account, so these commits do not even carry their name.++---++**Not on this list yet?** [`good first issue`](https://github.com/chaitanyagiri/munder-difflin/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22)+is kept stocked with small, self contained work, and [`CONTRIBUTING.md`](./CONTRIBUTING.md) has+everything else. Help that is not code counts too: a bug report with a clean reproduction is often+worth more than a patch, it just cannot be counted automatically here.++<sub>Generated by `scripts/generate-contributors.mjs`. Do not edit by hand; your changes will be+overwritten on the next merge. To credit a contribution that is in main without the merged badge,+add its pull request number to `.github/contributors-extra.json`.</sub>diff --git a/README.md b/README.mdindex befe45a4..a717a50d 100644--- a/README.md+++ b/README.md@@ -402,7 +402,13 @@ Questions, bugs, or want to show off your office? Join the Discord: **<https://d[`good first issue`](https://github.com/chaitanyagiri/munder-difflin/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22)list is kept stocked with small, self contained work that has a clear finish line.-<a href="https://github.com/chaitanyagiri/munder-difflin/graphs/contributors">+**Everyone whose code is in Munder Difflin is listed in [`CONTRIBUTORS.md`](./CONTRIBUTORS.md).**+If that is you, it is yours to point at. The list is generated from the pull requests themselves and+updates on its own, so you appear without having to ask. It also names the contributions that are in+`main` but that GitHub shows as closed rather than merged, because that was our mistake to record+and not theirs to explain.++<a href="./CONTRIBUTORS.md"><img src="https://contrib.rocks/image?repo=chaitanyagiri/munder-difflin" alt="Munder Difflin contributors"></a>diff --git a/docs/pr-evidence/contributors-after.jpg b/docs/pr-evidence/contributors-after.jpgnew file mode 100644index 00000000..86287f06Binary files /dev/null and b/docs/pr-evidence/contributors-after.jpg differdiff --git a/docs/pr-evidence/contributors-before.jpg b/docs/pr-evidence/contributors-before.jpgnew file mode 100644index 00000000..7c52c258Binary files /dev/null and b/docs/pr-evidence/contributors-before.jpg differdiff --git a/scripts/generate-contributors.mjs b/scripts/generate-contributors.mjsnew file mode 100644index 00000000..fdae5df9--- /dev/null+++ b/scripts/generate-contributors.mjs@@ -0,0 +1,153 @@+#!/usr/bin/env node+// Regenerates CONTRIBUTORS.md from MERGED PULL REQUESTS, plus the pull requests+// listed in .github/contributors-extra.json whose code is in main without the+// merged badge.+//+// Why not just link GitHub's contributors graph? Because that graph keys on the+// COMMIT AUTHOR EMAIL. If a contributor's git email is not attached to their+// GitHub account (a typo, a work address, a local hostname), their merged work+// is filed under an anonymous bucket and they never appear on that page at all.+// It fails silently, and it has already happened here.+//+// A pull request always has a real GitHub account attached to it, so generating+// from pull requests is both complete and stable.+//+// Usage: GH_TOKEN=... node scripts/generate-contributors.mjs [--check]++import { writeFileSync, readFileSync, existsSync } from 'node:fs';++const REPO = process.env.GITHUB_REPOSITORY || 'chaitanyagiri/munder-difflin';+const TOKEN = process.env.GH_TOKEN || process.env.GITHUB_TOKEN;+const OUT = 'CONTRIBUTORS.md';+const EXTRA = '.github/contributors-extra.json';+const CHECK = process.argv.includes('--check');++async function gh(path) {+ const res = await fetch(`https://api.github.com${path}`, {+ headers: {+ accept: 'application/vnd.github+json',+ ...(TOKEN ? { authorization: `Bearer ${TOKEN}` } : {}),+ 'user-agent': 'munder-difflin-contributors'+ }+ });+ if (!res.ok) throw new Error(`${path} -> ${res.status} ${await res.text()}`);+ return res.json();+}++// Bots are not people. Keep this list explicit rather than guessing from the name.+const BOTS = new Set(['github-actions[bot]', 'dependabot[bot]', 'wall-sync']);+const isBot = (u) => !u || u.type === 'Bot' || BOTS.has(u.login);++const people = new Map();+function record(user, date, { badged }) {+ const p = people.get(user.login) || {+ login: user.login, url: user.html_url,+ merged: 0, unbadged: 0, first: date, last: date+ };+ if (badged) p.merged += 1; else p.unbadged += 1;+ if (date < p.first) p.first = date;+ if (date > p.last) p.last = date;+ people.set(user.login, p);+ return p;+}++for (let page = 1; ; page++) {+ const batch = await gh(`/repos/${REPO}/pulls?state=closed&per_page=100&page=${page}`);+ if (!batch.length) break;+ for (const pr of batch) {+ if (!pr.merged_at || isBot(pr.user)) continue;+ record(pr.user, pr.merged_at, { badged: true });+ }+ if (batch.length < 100) break;+}++// Pull requests whose code is in main but which GitHub does not show as merged.+// Identity is read from the API rather than stored, so a rename follows on its own.+const landed = [];+if (existsSync(EXTRA)) {+ for (const entry of JSON.parse(readFileSync(EXTRA, 'utf8')).landed_without_merged_badge) {+ const pr = await gh(`/repos/${REPO}/pulls/${entry.pr}`);+ if (pr.merged_at) {+ throw new Error(`#${entry.pr} is merged on GitHub now. Remove it from ${EXTRA}.`);+ }+ if (isBot(pr.user)) continue;+ const date = pr.closed_at || pr.created_at;+ record(pr.user, date, { badged: false });+ landed.push({ ...entry, login: pr.user.login, url: pr.user.html_url, date });+ }+}++// Most contributions first, then earliest joiner, then alphabetical. Deterministic,+// so the file only changes when the facts change.+const total = (p) => p.merged + p.unbadged;+const list = [...people.values()].sort((a, b) =>+ total(b) - total(a) || a.first.localeCompare(b.first) || a.login.localeCompare(b.login));++landed.sort((a, b) => a.pr - b.pr);++const day = (iso) => iso.slice(0, 10);+const plural = (n) => (n === 1 ? '1 pull request' : `${n} pull requests`);+const commitLink = (sha) => `[\`${sha}\`](https://github.com/${REPO}/commit/${sha})`;++const row = (p) => {+ const name = `[@${p.login}](${p.url})${p.unbadged ? ' †' : ''}`;+ return `| ${name} | ${total(p)} | ${day(p.first)} | ${day(p.last)} |`;+};++const body = `# Contributors++Everyone on this list has code in Munder Difflin. If that is you, this file is yours to point at.++It is generated from the pull requests themselves rather than from commit metadata, so nobody is+dropped because their git email does not happen to match their GitHub account. It regenerates+whenever a pull request merges, so you appear without having to ask.++**${list.length} people** have contributed so far.++<a href="https://github.com/${REPO}/graphs/contributors">+ <img src="https://contrib.rocks/image?repo=${REPO}" alt="Contributor avatars">+</a>++| Contributor | Contributions | First | Most recent |+|---|---:|---|---|+${list.map(row).join('\n')}++_${plural(list.reduce((n, p) => n + total(p), 0))} from ${list.length} people._++## † Contributions that never got the merged badge++${landed.length} pull requests below are in main and their authors are contributors, but GitHub+shows them as closed rather than merged. On release night the pull requests were closed before the+release branch merged into main, so at the moment they closed, main did not contain their commits+yet. GitHub records the badge at that instant and will not let it be changed afterwards. It was our+sequencing mistake and it is not recoverable, so the record lives here instead. The full account is+in [discussion #353](https://github.com/${REPO}/discussions/353).++Every commit listed here was checked to be in \`main\` before it was added.++| Pull request | Contributor | In main |+|---|---|---|+${landed.map((e) => `| [#${e.pr}](https://github.com/${REPO}/pull/${e.pr}) | [@${e.login}](${e.url}) | ${e.commits.map(commitLink).join(', ')} |`).join('\n')}++${landed.filter((e) => e.note).map((e) => `**#${e.pr}** ${e.note}`).join('\n\n')}++---++**Not on this list yet?** [\`good first issue\`](https://github.com/${REPO}/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22)+is kept stocked with small, self contained work, and [\`CONTRIBUTING.md\`](./CONTRIBUTING.md) has+everything else. Help that is not code counts too: a bug report with a clean reproduction is often+worth more than a patch, it just cannot be counted automatically here.++<sub>Generated by \`scripts/generate-contributors.mjs\`. Do not edit by hand; your changes will be+overwritten on the next merge. To credit a contribution that is in main without the merged badge,+add its pull request number to \`.github/contributors-extra.json\`.</sub>+`;++if (CHECK) {+ const current = existsSync(OUT) ? readFileSync(OUT, 'utf8') : '';+ if (current !== body) { console.error(`${OUT} is stale. Run: node scripts/generate-contributors.mjs`); process.exit(1); }+ console.log(`${OUT} is up to date (${list.length} contributors).`);+} else {+ writeFileSync(OUT, body);+ console.log(`Wrote ${OUT}: ${list.length} contributors, ${landed.length} unbadged pull requests.`);+}