🏘️ Val Town Changelog Playground

Test and preview your Val Town changelog notifications before sending to Discord.

\n \n

📂 Monitored Repositories

\n \n

\n \n \n \n

Processing...

\n \n

Result

\n\n \n \n\n",[],[171,178],[171],{"_104":188,"_95":189,"_153":190,"_155":-5,"_156":139,"_157":191,"_159":22,"_106":192,"_100":32,"_161":193,"_163":194,"_164":22,"_165":-5,"_166":195,"_98":196},"1065e250-87a1-11f0-b12d-0224a6c84d84",".vtignore","1065e318-87a1-11f0-b12d-0224a6c84d84",30,["D",1756778628287],"file",".git\n.vscode\n.cursorrules\n.DS_Store\nnode_modules\nvendor",[],[189],{"_104":198,"_95":199,"_153":200,"_155":-5,"_156":139,"_157":181,"_159":22,"_106":201,"_100":32,"_161":193,"_163":202,"_164":22,"_165":-5,"_166":203,"_98":204},"b5ed22ee-8795-11f0-a101-0224a6c84d84","README.md","019907e0-1ceb-7489-89cb-2908087ec545",["D",1756773751853],"# GitHub to Discord Changelog Notifier\n\nA val that automatically fetches GitHub commits from **multiple repositories** and posts formatted changelog updates to Discord. It categorizes commits based on [conventional commit messages](https://www.conventionalcommits.org/en/v1.0.0/) ie. `feat:`, `fix:` etc., and uses AI to generate user-friendly summaries.\n\n**Example:**\n![Screenshot 2025-05-24 at 6.12.40 PM.png](https://imagedelivery.net/iHX6Ovru0O7AjmyT5yZRoA/112a693d-7482-42d8-171c-be2bf916cf00/public)\n\n### Configuration\n\n#### Repository Setup\n\nThe repositories to monitor are configured directly in the code in `process-commits.tsx`. Update the `REPOS` array to add or modify repositories:\n\n```typescript\nconst REPOS = [\n { owner: \"steel-dev\", name: \"steel-browser\", branch: \"main\" },\n { owner: \"steel-dev\", name: \"steel-api\", branch: \"develop\" },\n { owner: \"steel-dev\", name: \"steel-docs\", branch: \"main\" },\n];\n```\n\nEach repo configuration includes:\n\n- `owner`: GitHub repository owner/organization\n- `name`: Repository name\n- `branch`: Specific branch to monitor (e.g., \"main\", \"develop\", \"staging\")\n\n#### Environment Variables\n\nBefore you can run the cron or try out the playground, you must add the following Environment Variables (via left sidebar of this val):\n\n- `GITHUB_TOKEN`:\n - **For public repos, or personal repos:** Go to [GitHub Personal Access Tokens](https://github.com/settings/tokens) → Generate new token (classic) → Select `repo` scope\n - **For org-owned repos:** Go to [GitHub Personal Access Tokens](https://github.com/settings/tokens) → Resource Owner → Select the org the repo belongs to → read access to `Contents`. You will need approval from the org admin.\n- `DISCORD_WEBHOOK_URL`: In your Discord server → Server Settings → Integrations → Webhooks → New Webhook → Copy Webhook URL\n\n### How to use\n\n- **`gh-to-discord.tsx`** is a cron that runs automatically based on your configured schedule, fetching commits since the last run\n\n- **`playground.tsx`**\n You can also manually test this val using the `playground.tsx` HTTP endpoint.\n\n_Here's an [Example Playground with the `steel` repo](https://test-gh-to-discord.val.run/).\n![](https://filedumpthing.val.run/blob?key=blob_file_1748033253538_Google%20Chrome.gif)_\n\n## Key Features\n\n### Multi-Repository Support\n\n- Monitor multiple repositories simultaneously\n- Support for different branches per repository\n- Single unified changelog combining all repositories\n- Each commit shows which repository it came from: `[repo-name] commit message`\n\n### Commit Categorization\n\nThe bot automatically categorizes commits into the following sections (feel free to add more!):\n\n- ✨ **New Features** (`feat:`)\n- 🐛 **Bug Fixes** (`fix:`)\n- ⚙️ **Chores & Maintenance** (`chore:`)\n- 📋 **Other Updates** (uncategorized commits)\n\n## Customizing AI Summaries\n\nEach commit message is processed by GPT to generate a more user-friendly message.\n\nYou can modify the GPT prompt in the `generateUserFocusedSummary()` function in `process-commits.tsx`. You can paste in examples of past changelogs to help the LLM understand your desired tone.",[],[199],{"_104":206,"_95":207,"_153":208,"_155":-5,"_156":139,"_157":209,"_159":22,"_106":210,"_100":181,"_161":193,"_163":211,"_164":22,"_165":-5,"_166":212,"_98":213},"24a7c688-87a2-11f0-b986-0224a6c84d84","deno.json","10695e4e-87a1-11f0-b912-0224a6c84d84",39,["D",1756779091776],"{\n \"$schema\": \"https://raw.githubusercontent.com/denoland/deno/348900b8b79f4a434cab4c74b3bc8d4d2fa8ee74/cli/schemas/config-file.v1.json\",\n \"lock\": false,\n \"compilerOptions\": {\n \"noImplicitAny\": false,\n \"strict\": false,\n \"types\": [\n \"https://www.val.town/types/valtown.d.ts\"\n ],\n \"lib\": [\n \"dom\",\n \"dom.iterable\",\n \"dom.asynciterable\",\n \"deno.ns\",\n \"deno.unstable\"\n ]\n },\n \"lint\": {\n \"files\": {\n \"include\": [\n \"deno:/https/esm.town/**/*\"\n ]\n },\n \"rules\": {\n \"exclude\": [\n \"no-explicit-any\"\n ]\n }\n },\n \"node_modules_dir\": false,\n \"experimental\": {\n \"unstable-node-globals\": true,\n \"unstable-temporal\": true,\n \"unstable-worker-options\": true,\n \"unstable-sloppy-imports\": true\n }\n}",[],[207],{"_104":215,"_95":216,"_153":217,"_155":-5,"_156":139,"_157":209,"_159":22,"_106":218,"_100":219,"_161":220,"_163":221,"_164":22,"_165":-5,"_166":222,"_98":223},"24a7c868-87a2-11f0-b986-0224a6c84d84","gh-to-discord.tsx","019907e0-1ceb-7489-89cb-36d9df8d2b5e",["D",1756779091776],6,"interval","import { discordWebhook } from \"https://esm.town/v/stevekrouse/discordWebhook\";\nimport { fetchAndPostCommits } from \"./process-commits.tsx\";\n\nconst SEVEN_DAYS_MS = (7 * 24 * 60 * 60 * 1000) + 28800000;\n\n// Always look back 7 days \nexport default async function githubChangelogNotifier(): Promise {\n const now = new Date();\n const sevenDaysAgo = new Date(now.getTime() - SEVEN_DAYS_MS);\n\n const untilTimestamp = now.toISOString();\n const sinceTimestamp = sevenDaysAgo.toISOString();\n\n console.log(\n `Fetching commits from ${sinceTimestamp} to ${untilTimestamp} (last 7 days)`,\n );\n await fetchAndPostCommits(sinceTimestamp, untilTimestamp);\n}",[],[216],{"_104":225,"_95":226,"_153":227,"_155":-5,"_156":139,"_157":209,"_159":22,"_106":228,"_100":219,"_161":229,"_163":230,"_164":22,"_165":-5,"_166":231,"_98":232},"24a7c9bc-87a2-11f0-b986-0224a6c84d84","process-commits.tsx","019907e0-1ceb-7489-89cb-3c654011e42f",["D",1756779091776],"script","/**\n * Helper functions for cron (gh-to-discord.tsx) and playground.tsx\n */\n\nimport { OpenAI } from \"https://esm.town/v/std/openai\";\nimport { discordWebhook } from \"https://esm.town/v/stevekrouse/discordWebhook\";\nimport { Octokit } from \"npm:octokit\";\n\nconst REPOS = [\n { owner: \"val-town\", name: \"val.town\", branch: \"main\" },\n { owner: \"val-town\", name: \"sdk\", branch: \"main\" },\n { owner: \"val-town\", name: \"val-town-docs\", branch: \"main\" },\n];\n\nconst GITHUB_TOKEN = Deno.env.get(\"GITHUB_TOKEN\");\nconst DISCORD_WEBHOOK_URL = Deno.env.get(\"DISCORD_WEBHOOK_URL\");\nconst DISCORD_MESSAGE_LIMIT = 2000;\n\nconst SKIP_AUTHORS = [\n \"github-actions[bot]\",\n \"dependabot[bot]\", \n \"renovate[bot]\",\n \"stainless-app[bot]\",\n];\n\nfunction shouldSkipAuthor(commit: any): boolean {\n const author = commit.author?.login || commit.commit.author.name || \"\";\n return SKIP_AUTHORS.some(skipAuthor => author.toLowerCase().includes(skipAuthor.toLowerCase()));\n}\n\nasync function generateChangelog(commits: any[]): Promise> {\n const openai = new OpenAI();\n \n const commitList = commits.map(commit => \n `${commit._repoName}: ${commit.commit.message.split('\\n')[0]} (by ${commit.author?.login || commit.commit.author.name})`\n ).join('\\n');\n\n const prompt = `Create clean changelog entries for Val Town from these commits. Only include changes that users would actually notice and care about.\n\nVal Town is a platform for writing and running code online where users write vals (code snippets) that run in the cloud with HTTP endpoints.\n\nCommits:\n${commitList}\n\nCreate changelog entries organized by:\n- 🚀 New Features (major new functionality users can use)\n- 🐛 Bug Fixes (things that were broken and users experienced)\n- 📚 Documentation (help/docs that assist users)\n\nSKIP these entirely - do NOT include in any category:\n- Dependency upgrades, internal architecture, backend infrastructure\n- Code refactoring, cleanup, removing unused code \n- Developer tooling, build/deployment changes\n- Database changes, performance optimizations users can't see\n\nWriting guidelines:\n- Explain WHY the change matters to users (e.g., \"so you can test without opening a new tab\")\n- Remove marketing fluff like \"improving user experience\" \n- Be specific about what users can now do\n- Group related commits into single entries\n- No emojis in individual entries\n- Format: \"- Description of change\"\n\nGood examples:\n\"Microphone access is now supported in the HTTP preview iframe so you can test audio features without opening a new tab\"\n\"Fixed authentication styles that were preventing proper login on mobile devices\"\n\nReturn ONLY the organized changelog entries, no extra text.`;\n\n try {\n const completion = await openai.chat.completions.create({\n messages: [{ role: \"user\", content: prompt }],\n model: \"gpt-4o-mini\", \n max_tokens: 500,\n temperature: 0.2,\n });\n\n const response = completion.choices[0]?.message?.content?.trim();\n if (!response) throw new Error(\"No response\");\n \n const sections = response.split(/(?=🚀|🐛|📚|🔄)/);\n const categorizedCommits: Record = {};\n \n for (const section of sections) {\n const lines = section.trim().split('\\n');\n if (lines.length < 2) continue;\n \n const title = lines[0].trim();\n const messages = lines.slice(1).filter(line => line.trim().startsWith('-'));\n \n if (title && messages.length > 0) {\n categorizedCommits[`**${title}**`] = { messages };\n }\n }\n \n return categorizedCommits;\n } catch (error) {\n console.warn(\"Failed to generate changelog, falling back to basic categorization:\", error);\n return {};\n }\n}\n\nexport async function categorizeCommits(commits: any[]) {\n const filteredCommits = commits.filter(commit => !shouldSkipAuthor(commit));\n console.log(`Filtered out ${commits.length - filteredCommits.length} commits from bots`);\n\n return await generateChangelog(filteredCommits);\n}\n\nexport function buildDiscordMessage(\n categorizedCommits: Record,\n _: string,\n since: string,\n until: string,\n): string {\n let messageBody = \"\";\n\n for (const titleKey in categorizedCommits) {\n messageBody += `\\n${titleKey}\\n${categorizedCommits[titleKey].messages.join(\"\\n\")}\\n`;\n }\n\n if (!messageBody.trim()) messageBody = \"\\nNo changes.\";\n\n const repoList = REPOS.map(repo => `[${repo.name}](https://github.com/${repo.owner}/${repo.name})`).join(\", \");\n const startDate = new Date(since).toLocaleDateString();\n \n return `Changelog for ${repoList} - Week of ${startDate}:${messageBody}`;\n}\n\nfunction splitDiscordMessage(content: string): string[] {\n if (content.length <= DISCORD_MESSAGE_LIMIT) return [content];\n\n const messages: string[] = [];\n const lines = content.split(\"\\n\");\n let current = \"\";\n let isFirst = true;\n\n for (const line of lines) {\n const potential = current + (current ? \"\\n\" : \"\") + line;\n\n if (potential.length > DISCORD_MESSAGE_LIMIT) {\n if (current.trim()) {\n messages.push(current.trim());\n current = \"\";\n isFirst = false;\n }\n\n if (line.length > DISCORD_MESSAGE_LIMIT) {\n const truncated = line.substring(0, DISCORD_MESSAGE_LIMIT - 15) + \"... (truncated)\";\n messages.push(isFirst ? truncated : \"(continued)\\n\" + truncated);\n isFirst = false;\n } else {\n current = isFirst ? line : \"(continued)\\n\" + line;\n isFirst = false;\n }\n } else {\n current = potential;\n }\n }\n\n if (current.trim()) messages.push(current.trim());\n return messages;\n}\n\nexport async function fetchCommits(since: string, until: string): Promise {\n if (!GITHUB_TOKEN) throw new Error(\"Missing GITHUB_TOKEN\");\n \n const octokit = new Octokit({ auth: GITHUB_TOKEN });\n console.log(`Fetching commits from ${REPOS.length} repositories between ${since} and ${until}`);\n \n const allCommits: any[] = [];\n\n for (const repo of REPOS) {\n try {\n console.log(`Fetching from ${repo.owner}/${repo.name}`);\n const response = await octokit.rest.repos.listCommits({\n owner: repo.owner,\n repo: repo.name,\n sha: repo.branch,\n since,\n until,\n });\n\n console.log(`${repo.name}: ${response.data.length} commits`);\n const tagged = response.data.map(commit => ({\n ...commit,\n _repoName: repo.name,\n _repoOwner: repo.owner,\n _repoBranch: repo.branch,\n }));\n\n allCommits.push(...tagged);\n } catch (error) {\n console.error(`Error fetching ${repo.owner}/${repo.name}:`, error.message);\n console.log(`Skipping ${repo.name}...`);\n }\n }\n\n console.log(`Total commits: ${allCommits.length}`);\n return allCommits;\n}\n\nexport async function fetchAndPostCommits(since: string, until: string): Promise {\n if (!DISCORD_WEBHOOK_URL) throw new Error(\"Missing DISCORD_WEBHOOK_URL\");\n\n const commits = await fetchCommits(since, until);\n if (commits.length === 0) {\n console.log(`No commits found between ${since} and ${until}`);\n return;\n }\n\n console.log(`Processing ${commits.length} commits`);\n const categorizedCommits = await categorizeCommits(commits);\n const message = buildDiscordMessage(categorizedCommits, \"\", since, until);\n const parts = splitDiscordMessage(message);\n\n console.log(`Sending ${parts.length} Discord message(s)`);\n for (let i = 0; i < parts.length; i++) {\n await discordWebhook({ url: DISCORD_WEBHOOK_URL, content: parts[i] });\n if (i < parts.length - 1) await new Promise(r => setTimeout(r, 1000));\n }\n\n console.log(`Sent ${parts.length} message(s) to Discord`);\n}",[],[226],"files",[151,169,176,187,197,205,214,224],"counts",{"_237":32,"_238":181,"_239":32,"_240":241},"pulls","branches","forks","envVars",2,"contents",[],{"_104":152,"_95":99,"_153":154,"_155":-5,"_156":139,"_157":158,"_159":22,"_106":245,"_100":32,"_161":162,"_163":-5,"_164":22,"_165":-5,"_98":246},["D",1756780696628],[99],"upstreamProject","upstreamBranch","emptyEnvVars","isNew","flags",[],"routes/_app.x.$handle.$name.branch.$branch.version.$version.code.$",{"_93":94,"_95":96,"_97":43,"_100":101,"_98":99,"_102":255,"_149":260,"_233":285,"_193":286,"_242":288,"_289":-5,"_290":22,"_291":-5,"_292":-5,"_293":-5,"_294":295},{"_104":105,"_95":96,"_106":256,"_108":-5,"_109":22,"_110":111,"_112":113,"_114":-5,"_14":115,"_116":-5,"_117":22,"_118":-5,"_119":32,"_16":120,"_121":122,"_123":122,"_124":125,"_126":125,"_127":125,"_128":122,"_129":122,"_23":257,"_133":258,"_136":259,"_148":22},["D",1756773751853],{"_93":94,"_131":132},{"_93":94,"_135":132},{"_100":138,"_95":43,"_104":139,"_140":105,"_141":-5,"_142":-5,"_143":-5,"_144":-5,"_145":-5,"_146":96,"_147":94},[261,264,270,273,276,279,282],{"_104":152,"_95":99,"_153":154,"_155":-5,"_156":139,"_157":158,"_159":22,"_106":160,"_100":32,"_161":162,"_163":-5,"_164":22,"_165":-5,"_166":262,"_98":263},[],[99],{"_104":170,"_95":171,"_153":172,"_155":-5,"_156":139,"_157":173,"_159":22,"_106":174,"_100":32,"_161":162,"_163":-5,"_164":22,"_165":-5,"_166":265,"_98":269},[266],{"_104":177,"_95":178,"_153":179,"_155":172,"_156":139,"_157":101,"_159":22,"_106":180,"_100":181,"_161":182,"_163":183,"_164":22,"_165":-5,"_166":267,"_98":268},[],[171,178],[171],{"_104":188,"_95":189,"_153":190,"_155":-5,"_156":139,"_157":191,"_159":22,"_106":192,"_100":32,"_161":193,"_163":194,"_164":22,"_165":-5,"_166":271,"_98":272},[],[189],{"_104":198,"_95":199,"_153":200,"_155":-5,"_156":139,"_157":181,"_159":22,"_106":201,"_100":32,"_161":193,"_163":202,"_164":22,"_165":-5,"_166":274,"_98":275},[],[199],{"_104":206,"_95":207,"_153":208,"_155":-5,"_156":139,"_157":209,"_159":22,"_106":210,"_100":181,"_161":193,"_163":211,"_164":22,"_165":-5,"_166":277,"_98":278},[],[207],{"_104":215,"_95":216,"_153":217,"_155":-5,"_156":139,"_157":209,"_159":22,"_106":218,"_100":219,"_161":220,"_163":221,"_164":22,"_165":-5,"_166":280,"_98":281},[],[216],{"_104":225,"_95":226,"_153":227,"_155":-5,"_156":139,"_157":209,"_159":22,"_106":228,"_100":219,"_161":229,"_163":230,"_164":22,"_165":-5,"_166":283,"_98":284},[],[226],[261,264,266,270,273,276,279,282],{"_104":152,"_95":99,"_153":154,"_155":-5,"_156":139,"_157":158,"_159":22,"_106":245,"_100":32,"_161":162,"_163":-5,"_164":22,"_165":-5,"_98":287},[99],[],"upstream","showCompareCallout","pull","ahead","behind","templates",[],"actionData","errors"]

charmaine

AI-Change-Logs