Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory.
TypeScript agentaiai-agentsall-in-onecrmcrm-systememaillinearmcpmessagingnotesnotionofficerustslackslack-alternativestartupstartup-toolstypescriptworkspace
/**
* Pulls releases from macro-inc/macro matching the vYYYY.M.D.N format
* and generates changelog MDX pages using <Update> components: one
* landing page (introduction.mdx) with the latest month's releases, plus
* one archive page per month so no single route carries every release.
*
* Usage: bun run scripts/generate-changelog.ts
*
* Requires: GITHUB_TOKEN env var (or gh CLI auth)
*/
import { mkdirSync, writeFileSync, readFileSync, readdirSync, rmSync } from "fs";
import { join } from "path";
const REPO = "macro-inc/macro";
const CHANGELOG_DIR = join(import.meta.dirname, "../changelog");
const DOCS_JSON_PATH = join(import.meta.dirname, "../docs.json");
const TAG_PATTERN = /^v\d{4}\.\d{1,2}\.\d{1,2}\.\d+$/;
interface Release {
tag_name: string;
name: string | null;
body: string | null;
published_at: string;
}
async function fetchAllReleases(): Promise<Release[]> {
const releases: Release[] = [];
let page = 1;
while (true) {
const url = `https://api.github.com/repos/${REPO}/releases?per_page=100&page=${page}`;
const headers: Record<string, string> = {
Accept: "application/vnd.github+json",
};
const token = process.env.GITHUB_TOKEN;
if (token) {
headers.Authorization = `Bearer ${token}`;
}
const res = await fetch(url, { headers });
if (!res.ok) {
throw new Error(`GitHub API error: ${res.status} ${res.statusText}`);
}
const batch: Release[] = await res.json();
if (batch.length === 0) break;
releases.push(...batch);
page++;
}
return releases;
}
function escapeForMdx(text: string): string {
return text.replace(
/<(?!\/?(?:br|hr|img|a |ul|ol|li|p |h[1-6]|code|pre|em|strong|b |i |table|thead|tbody|tr|td|th|div|span|sup|sub|blockquote|details|summary|dd|dl|dt|del|ins|kbd|mark|s |u |var|wbr|abbr|cite|dfn|q |ruby|rt|rp|samp|small|time|data|meter|progress|output|dialog|slot|template|picture|source|track|video|audio|canvas|map|area|section|nav|article|aside|header|footer|main|figure|figcaption|caption|col|colgroup|fieldset|legend|datalist|optgroup|option|textarea|select|button|label|input|form))/g,
"\\<"
);
}
const MONTH_NAMES = [
"January",
"February",
"March",
"April",
"May",
"June",
"July",
"August",
"September",
"October",
"November",
"December",
];
/** Year and month parsed from a vYYYY.M.D.N tag. */
function tagMonth(tag: string): { year: number; month: number } {
const [year, month] = tag.slice(1).split(".").map(Number);
return { year, month };
}
function renderUpdate(r: Release, current: boolean): string {
const label = current ? `${r.tag_name} (Current)` : r.tag_name;
const body = escapeForMdx((r.body ?? "").trim());
return ` <Update label="${label}">\n${body}\n </Update>`;
}
async function main() {
console.log(`Fetching releases from ${REPO}...`);
const allReleases = await fetchAllReleases();
const releases = allReleases
.filter((r) => TAG_PATTERN.test(r.tag_name))
.sort(
(a, b) =>
new Date(b.published_at).getTime() - new Date(a.published_at).getTime()
);
console.log(
`Found ${releases.length} releases matching ${TAG_PATTERN.source}`
);
// Clean out old generated MDX files
mkdirSync(CHANGELOG_DIR, { recursive: true });
for (const file of readdirSync(CHANGELOG_DIR)) {
rmSync(join(CHANGELOG_DIR, file));
}
// Group releases by tag month, newest month first (releases are already
// sorted newest-first, so insertion order is the display order)
const months = new Map<string, Release[]>();
for (const r of releases) {
const { year, month } = tagMonth(r.tag_name);
const key = `${year}-${String(month).padStart(2, "0")}`;
(months.get(key) ?? months.set(key, []).get(key)!).push(r);
}
const monthKeys = [...months.keys()];
const [latestKey, ...archiveKeys] = monthKeys;
// Landing page: the latest month's releases
const latestReleases = months.get(latestKey) ?? [];
const latestUpdates = latestReleases.map((r, i) => renderUpdate(r, i === 0));
const intro = `---
title: Changelog
icon: clock-rotate-left
description: All notable changes to Macro, pulled from GitHub Releases.
---
All notable changes to Macro, pulled from [GitHub Releases](https://github.com/${REPO}/releases).
Releases follow the format \`vYYYY.M.D.patch\`. Earlier months are in the sidebar.
${latestUpdates.join("\n\n")}
`;
writeFileSync(join(CHANGELOG_DIR, "introduction.mdx"), intro);
console.log(
`Wrote changelog/introduction.mdx (${latestReleases.length} releases)`
);
// One archive page per earlier month
for (const key of archiveKeys) {
const [year, month] = key.split("-").map(Number);
const title = `${MONTH_NAMES[month - 1]} ${year}`;
const monthReleases = months.get(key)!;
const updates = monthReleases.map((r) => renderUpdate(r, false));
const mdx = `---
title: "${title}"
description: "Macro releases from ${title}."
---
${updates.join("\n\n")}
`;
writeFileSync(join(CHANGELOG_DIR, `${key}.mdx`), mdx);
console.log(`Wrote changelog/${key}.mdx (${monthReleases.length} releases)`);
}
// Update docs.json with changelog tab: latest month up top, then one
// group per year of archive pages
const docsJson = JSON.parse(readFileSync(DOCS_JSON_PATH, "utf-8"));
const tabs = docsJson.navigation.tabs as Array<Record<string, unknown>>;
const filtered = tabs.filter(
(t) => (t.tab as string).toLowerCase() !== "changelog"
);
const yearGroups: Array<{ group: string; pages: string[] }> = [];
for (const key of archiveKeys) {
const year = key.split("-")[0];
let group = yearGroups.find((g) => g.group === year);
if (!group) {
group = { group: year, pages: [] };
yearGroups.push(group);
}
group.pages.push(`changelog/${key}`);
}
filtered.push({
tab: "Changelog",
groups: [
{
group: "Releases",
pages: ["changelog/introduction"],
},
...yearGroups,
],
});
docsJson.navigation.tabs = filtered;
writeFileSync(DOCS_JSON_PATH, JSON.stringify(docsJson, null, 2) + "\n");
console.log("Updated docs.json");
}
main().catch((err) => {
console.error(err);
process.exit(1);
});