Skip to content

Open-source manufacturing ERP, MES and QMS. Quoting, MRP, inventory, shop floor, quality and lot/serial traceability on one Postgres schema, with a REST API and MCP server. Self-host or use Carbon Cloud.

feat(changelog): docs changelog with email newsletter and in-app What's new card (#1578)

Naveen Kashyap879a0adbebed
diff --git a/.ai/plans/2026-09-04-docs-changelog.md b/.ai/plans/2026-09-04-docs-changelog.md
new file mode 100644
index 0000000000..1fc4a4dded
--- /dev/null
+++ b/.ai/plans/2026-09-04-docs-changelog.md
@@ -0,0 +1,51 @@
+# Docs-site changelog (docs.carbon.ms/changelog)
+
+Decision (researched 2026-09-04): Carbon deploys continuously with no versions/tags, so the
+changelog is **date-based**, published as a third Fumadocs collection on the existing docs
+site. No changesets/release-please/tagging, no new hosting — the docs Vercel Git integration
+deploys it on merge to `main`. Pattern matches Supabase/Vercel/GitHub (dated feed + RSS) and
+the official Fumadocs blog recipe.
+
+## Design
+
+- One MDX file per entry at `docs/content/changelog/YYYY-MM-DD-slug.mdx`, frontmatter
+ `{ title, description, date, tags? }`. Entries are curated + user-facing (drafted from
+ merged `feat:`/`fix:` PRs, then edited), never commit dumps.
+- `/changelog` renders the full feed inline, newest first (Supabase-style scannable feed);
+ `/changelog/[slug]` is the permalink per entry. `/changelog/rss.xml` is the feed.
+- Uses the existing MainHeader (new "Changelog" nav item) + reference-surface styling.
+
+## Tasks
+
+- [x] 1. `docs/source.config.ts` — add `changelog` collection (`content/changelog`,
+ pageSchema + `date` + optional `tags`).
+- [x] 2. `docs/lib/source.ts` — export `changelogSource` (baseUrl `/changelog`) +
+ a date-sorted `getChangelogEntries()` helper.
+- [x] 3. Routes:
+ - `docs/app/changelog/layout.tsx` — MainHeader (active `changelog`) + footer chrome.
+ - `docs/app/changelog/page.tsx` — feed page, full MDX bodies inline, anchor per entry.
+ - `docs/app/changelog/[slug]/page.tsx` — permalink page, `generateStaticParams`.
+ - `docs/app/changelog/rss.xml/route.ts` — static RSS 2.0 from the collection.
+- [x] 4. Nav: add "Changelog" to `NAV` in both `components/main-header.tsx` and
+ `components/mobile-nav.tsx` (duplicated consts, both must change).
+- [x] 5. SEO: entries + index in `app/sitemap.ts`; `pageSeo` metadata; RSS `<link>`
+ alternate on the changelog surface.
+- [x] 6. First entry drafted from merged PRs since mid-August (curated, grounded).
+- [x] 7. Verify: `pnpm --filter docs build` green (safe here — isolated Conductor
+ worktree, no dev server on 3002); internal links resolve.
+
+## Follow-up (2026-09-05): Linear-style feed UI
+
+- [x] Feed restyled after linear.app/changelog, in the warm-paper language: per-entry
+ grid with a sticky date+tags rail on the left (`md:grid-cols-[9.5rem_minmax(0,1fr)]`),
+ 27px demi title, optional hero image, prose right column; rail collapses to a row
+ above the title on mobile. Container widened to `max-w-225`.
+- [x] `image` frontmatter (optional, path under `/public`) added to the collection schema;
+ rendered as a rounded, hairline-bordered hero on both the feed and permalink pages.
+- [x] Verified: build green, grid/sticky/title utilities present in built CSS.
+
+## Out of scope (later, optional)
+
+- ERP HelpMenu "What's new" link (`apps/erp/app/utils/path.ts` + `HelpMenu.tsx`).
+- Mirroring entries to GitHub Releases/Discussions.
+- A `/changelog-draft` helper that drafts an entry from `gh pr list --search "merged:>DATE"`.
diff --git a/.claude/rules/changelog-authoring.md b/.claude/rules/changelog-authoring.md
new file mode 100644
index 0000000000..d98c8cf2ff
--- /dev/null
+++ b/.claude/rules/changelog-authoring.md
@@ -0,0 +1,129 @@
+paths:
+ - "docs/content/changelog/**"
+ - "docs/components/changelog-*.tsx"
+ - "docs/lib/changelog*.ts*"
+ - "docs/app/changelog/**"
+
+# Authoring a changelog entry
+
+One MDX file per dated entry in `docs/content/changelog/`, named
+`YYYY-MM-DD-slug.mdx`. Carbon has no versions, so `date` is the ordering key and
+the filename's date must match the frontmatter's.
+
+The entry is read in **four** places, which is what constrains the format:
+
+| Surface | Shows | Built by |
+|---|---|---|
+| `/changelog` feed | `title` + `description` + first 3 tags only | `changelog-feed.tsx` |
+| `/changelog/<slug>` | the full body | `[slug]/page.tsx` |
+| `/changelog/rss.xml` | `description` **and** the full body as HTML | `rss.xml/route.ts` |
+| ERP "What's new" panel | `title` + `description` | `getChangelogPanelEntry` |
+
+So `description` is not a summary you can skip — it is the whole feed row, the
+newsletter blurb and the in-app toast.
+
+## Frontmatter
+
+```yaml
+---
+title: "Returns, operation batching, and the Carbon API"
+description: "Customer RMAs and supplier returns, job operations that run as one batch, and the Carbon API over plain HTTP."
+date: "2026-09-18"
+tags: ["sales", "purchasing", "production"]
+---
+```
+
+- **`title`** — names the things that shipped, not a slogan.
+- **`description`** — **15–20 words, one or two clauses.** It is the entire feed
+ row; a 40-word run-on is a wall there. Use `Plus …` to gather the tail
+ (`"Draft an engineering change … Plus inventory valuation and assembly instructions."`).
+- **`tags`** — most important first; the feed shows only the first three.
+- **`image`** — optional hero, a path under `docs/public/changelog/`. Rendered above the
+ title on both the feed row and the entry page, and it carries a shared
+ `view-transition-name` so the card morphs between them.
+
+## Thumbnails
+
+**Generated, not hand-drawn.** `docs/scripts/generate-changelog-thumbnail.mjs` writes
+`docs/public/changelog/<slug>.svg` for every entry and stamps `image:` into the
+frontmatter when it is missing:
+
+```bash
+cd docs && pnpm generate:changelog-thumbnails # all
+cd docs && pnpm generate:changelog-thumbnails <slug> # one
+```
+
+The motif is derived from the **title**: whichever motif keyword appears earliest wins,
+since a changelog title leads with its headline feature ("Ramp card transactions, batch
+materials, …" is a ledger entry, not a batching one). Layout detail is varied by a hash
+of the slug, so entries sharing a motif differ, and a rerun is byte-identical.
+
+House style, enforced by the primitives in that script: 1200×675, dark and flat. Field
+`#09090B`, panel `#141518`, hairline `#26272B`, solid fills only. No gradients, no
+shadows, no `fill-opacity`, no text, no logos, one `#00B0FF` accent per image. These
+render at ~56% in the feed, so detail is lost and only clutter survives.
+
+A literal version was tried once — real part numbers, work centres and status pills from
+the demo dataset — and rejected: unreadable at feed scale and busy rather than
+convincing. If you ever want true realism, screenshot the running app
+(`pnpm db:seed:dev --dataset satellite` fills every screen) the way
+`docs/public/screens/` was made, rather than drawing it.
+
+**A new subject with no motif gets a new motif** in `MOTIFS` plus a drawing function —
+never a hand-authored one-off SVG, or the set drifts out of style. Never draw a third
+party's logo, and never use real tenant data.
+
+## Body — concise, useful, linked
+
+Modelled on Linear's and Commit's changelogs. The failure mode to avoid is what
+these entries used to be: 100-word unbroken paragraphs, no links, no idea where
+in the product the thing lives.
+
+1. **Lead with why, then what** — one or two sentences before the first `##`.
+ Name the problem, then the thing that solves it.
+2. **One `##` per feature, 1–3 sentences.** Keep a paragraph under ~60 words. If
+ it needs more, it wants a bullet list.
+3. **Link the feature to its reference page on first mention.** There are ~94
+ pages under `docs/content/docs/reference/` — check for one before writing a
+ bare noun. `find docs/content/docs -name '*.mdx'` is the index.
+4. **Say where it is** when the entry knows: `Automate → Workflows`,
+ `Account → Notifications`. Do not invent a path you have not verified.
+5. **State plan gating inline** — "available on the Business plan".
+6. **`<Accordion title="Improvements">` / `"Fixes"` last**, one line per bullet.
+ On the entry page these render expanded (`ChangelogSection`), not collapsed.
+
+**Never invent a product fact to fill the shape.** An entry describes what
+merged; if you cannot verify a detail, leave it out.
+
+## Components available
+
+An entry is ordinary MDX with the full editorial vocabulary — `Callout`,
+`Screenshot`, `Steps`/`Step`, `Cards`/`Card`, `PlanBadge`, `Term`, `Figure`,
+`Accordion`, code fences, tables.
+
+**Every component an entry uses needs a plain-HTML stand-in in
+`docs/lib/changelog-feed-components.tsx`.** Feed readers and mail clients run no
+components. A component missing from that map renders `undefined` and **fails the
+build** — deliberately, because a newsletter that silently drops a section is
+worse than a red build. Adding a component to the vocabulary means adding its
+degrade there in the same change.
+
+Note `Callout` here is the Reference one — `{ type, title, children }` — not the
+Guides variant with `tone`/`badge`.
+
+## Checks before committing
+
+```bash
+pnpm --filter docs typecheck
+curl -s localhost:3002/changelog/rss.xml | grep -c '<item>' # every entry still renders
+```
+
+Every internal link must resolve — a `/docs/...` path with no matching file 404s
+silently in the feed and the newsletter:
+
+```bash
+cd docs && for l in $(grep -oh "](/docs/[^)]*)" content/changelog/*.mdx \
+ | sed 's|](/docs/||;s|)||' | sort -u); do
+ [ -f "content/docs/$l.mdx" ] || [ -f "content/docs/$l/index.mdx" ] \
+ || echo "MISSING $l"; done
+```
diff --git a/.claude/rules/email-design.md b/.claude/rules/email-design.md
new file mode 100644
index 0000000000..62d769f6d7
--- /dev/null
+++ b/.claude/rules/email-design.md
@@ -0,0 +1,62 @@
+---
+paths:
+ - "packages/documents/src/email/**"
+ - "packages/jobs/src/inngest/functions/notifications/**"
+ - "packages/jobs/src/inngest/functions/tasks/changelog-dispatch*"
+---
+
+# Email Design — every email is the notification card
+
+Carbon sends one kind of email: the **card** that `NotificationEmail` renders
+(`packages/documents/src/email/NotificationEmail.tsx`). Transactional, lifecycle, and
+broadcast emails (`MfaRequiredEmail`, `ChangelogEntryEmail`, …) are
+the same card with different copy. A new email that looks different from a notification
+is a bug, not a design choice. Grounded in the templates and `components/` in that folder.
+
+## Where things live
+
+| What | Where |
+|---|---|
+| Templates | `packages/documents/src/email/*.tsx`, exported from `index.ts` → `@carbon/documents/email` |
+| Shared chrome | `components/Theme.tsx` (`EmailThemeProvider`, `getEmailThemeClasses`, Geist font, dark-mode meta), `components/Logo.tsx`, `components/notificationStyles.ts` (the `nf-*` classes) |
+| Rendering | jobs code: `render(SomeEmail({ ...props }))` from `@react-email/components` — a plain function call, no JSX in `@carbon/jobs` |
+| Sending | the `carbon/send-email` event (`notifications/send-email.ts`, needs a `companyId`) or `sendEmail` from `@carbon/lib/email.server` directly for platform mail with no company (`tasks/changelog-dispatch.ts`) — both go through the shared SMTP transport, which no-ops (`data: null`) when no `SMTP_*` / `RESEND_API_KEY` is configured |
+| Previews | `src/email/previews/` — **one fixture per shipped email**, `pnpm --filter @carbon/documents email:previews` |
+
+**Never build email HTML by string concatenation.** The changelog emails briefly did; that
+is exactly how a template drifts from the card (different font, colors, no dark mode, no
+`Logo`). Write a `.tsx` template in `@carbon/documents`, render it in the job.
+
+## The card, top to bottom
+
+Copy `MfaRequiredEmail.tsx` for a single-CTA email or `NotificationEmail.tsx` when there
+are label/value details. Every piece below is load-bearing:
+
+1. `<EmailThemeProvider preview={<Preview>…</Preview>} additionalHeadContent={<style>{notificationStyles}</style>}>` — the `Preview` is the inbox snippet; the `notificationStyles` are what make dark mode work.
+2. `<Body className="my-auto mx-auto font-sans nf-body …themeClasses.body">`.
+3. `<Container className="my-[40px] mx-auto p-[36px] max-w-[560px] rounded-[16px] nf-card …" style={{ borderRadius: 16, borderStyle: "solid", borderWidth: 1 }}>` — 560px, radius 16, 1px border.
+4. `<Logo />` — the wordmark. Its `src` must be PUBLICLY reachable (the recipient's mail client fetches it): production/preview use `getAppUrl()`, anything else (a `crbn up` dev origin, localhost) falls back to `https://app.carbon.ms`.
+5. **Eyebrow** — `text-[11px] uppercase … nf-eyebrow`, `letterSpacing: "0.14em"`, `mt-[40px] mb-[10px]`. Names the category: "New notification", "Security", "Changelog".
+6. **Heading** — `text-[26px] font-medium text-center tracking-tight … mb-[32px]`. The action or title, one line.
+7. **Greeting** — `Hi {recipientName ?? "there"},` at `text-[15px] leading-[26px]`. Only when the recipient is a Carbon user with a name; a bare email address (a changelog subscriber) gets no greeting.
+8. **Callout** — `<Section className="nf-callout" style={{ backgroundColor: "#fafafa", borderColor: "#ececef", borderRadius: 12, borderStyle: "solid", borderWidth: 1, marginBottom: 28, padding: "18px 20px" }}>` with a `role="presentation"` table inside. For a notification about a RECORD, the message/reference lives here at `text-[15px] leading-[24px]`, with details as label/value rows at `text-[13px]` split by an `nf-divider`. An announcement with no record (`ChangelogEntryEmail`) skips the box and sets its description as centered prose under the heading instead.
+9. **CTA** — one `<Button className="nf-cta" style={{ backgroundColor: "#0e0e0e", borderColor: "#0e0e0e", borderRadius: 10, …, padding: "13px 24px", fontSize: 14, fontWeight: 500 }}>`, centered, `mb-[24px]`. One button per email.
+10. **Fallback link** — "Or open this link in your browser:" + the raw URL at `text-[13px] … break-all nf-fallback`. Always, for clients that strip buttons.
+11. **Footer** (when the reader might not know why they got it) — `<Hr className="my-[32px] nf-divider …" />` then `text-[12px] leading-[18px] … nf-fallback`: why they received it + the action link ("Manage notification settings", "Unsubscribe").
+
+## Rules that are not style
+
+- **Dark mode is done by CLASS, not inline style.** Backgrounds go through `nf-*` classes so the `!important` media-query overrides in `notificationStyles` can flip them; an inline `background-color` beats them and renders a white card on a black Gmail. Text colors use `getEmailThemeClasses()` (`email-text`, `email-muted`, …). Off-black `#0e0e0e` and off-white `#fefefe`, never pure `#000`/`#fff` — pure values get auto-inverted by some clients.
+- **No sample defaults on content props.** `NotificationEmail` deliberately gives `heading`/`message` no defaults: fabricated data must never reach a real recipient. Sample data lives in the preview fixture only. (Some older templates — `VerificationEmail` — still default their props; don't copy that, or their pre-card layout.)
+- **Always send a `text` alternative** alongside `html` — the job builds it from the same content (see `entryEmailContent` in `packages/jobs/src/inngest/functions/tasks/changelog-dispatch.feed.ts`).
+- **Broadcast mail carries a `List-Unsubscribe` header** and a footer link to where the reader turns it off. For the changelog newsletter that is the signed-in Account → Notifications page (only the user may change their preference), so there is no one-click `List-Unsubscribe-Post` and the email renders once per entry, not per recipient.
+- **Links in customer-authored text are not links** unless they pass `renderInlineLinks` against the ERP origin (`NotificationEmail` `details`) — an `https://` in a body someone typed stays literal text.
+- **Add the preview fixture in the same change** (`previews/<Name>.tsx`, props filled with obviously-sample values like "Acme Manufacturing" / "John Doe") — it is the only way anyone sees the email before a customer does.
+
+## Checklist for a new email
+
+- [ ] `packages/documents/src/email/<Name>Email.tsx`, copied from `MfaRequiredEmail.tsx` or `NotificationEmail.tsx`, all eleven pieces present
+- [ ] Exported from `src/email/index.ts`
+- [ ] `previews/<Name>Email.tsx` fixture
+- [ ] Job renders with `render(NameEmail({ ...props }))` — a function call, never JSX — and sends `html` + `text` (+ unsubscribe headers if broadcast)
+- [ ] `pnpm --filter @carbon/documents typecheck` and `email:previews` checked in light AND dark
diff --git a/.claude/skills/changelog-entry/SKILL.md b/.claude/skills/changelog-entry/SKILL.md
new file mode 100644
index 0000000000..69a58cbd26
--- /dev/null
+++ b/.claude/skills/changelog-entry/SKILL.md
@@ -0,0 +1,115 @@
+---
+name: changelog-entry
+description: >-
+ Write and ship a Carbon changelog entry end to end: ground it in what actually merged,
+ write the MDX in the house format, generate its thumbnail, and verify the feed, the
+ permalink and the RSS newsletter all still render. Use whenever someone asks to add,
+ write, draft or publish a changelog entry, to "write up" a release or a batch of merged
+ work, or to regenerate changelog thumbnails. Not for the docs Guide or Reference (use
+ carbon-docs) and not for release notes that live outside docs/content/changelog.
+---
+
+# changelog-entry — write and ship a changelog entry
+
+**Announce at start:** "Using the changelog-entry skill — writing {date} and generating its thumbnail."
+
+The full conventions live in `.claude/rules/changelog-authoring.md`; read it first. This
+skill is the workflow around them.
+
+## The surfaces an entry feeds
+
+One MDX file reaches four places, which is why the format is constrained:
+
+| Surface | Shows |
+|---|---|
+| `/changelog` | `title` + `description` + first 3 tags + thumbnail |
+| `/changelog/<slug>` | the full body |
+| `/changelog/rss.xml` | `description` **and** the body as HTML |
+| ERP "What's new" panel | `title` + `description` |
+
+`description` is therefore not optional garnish — it is the entire feed row, the
+newsletter blurb and the in-app toast.
+
+## Workflow
+
+### 1. Ground it — never write from the diff summary alone
+
+Establish what actually shipped before writing a word:
+
+```bash
+git log --oneline <since>..main | cat
+gh pr list --state merged --limit 40 --json number,title,mergedAt,labels
+```
+
+For each candidate feature, open the code or the reference page and confirm the claim.
+**Never invent a product fact to fill the shape.** If you cannot verify a detail, leave
+it out. An entry is a record of what merged, not a wish list.
+
+### 2. Pick the date and slug
+
+`docs/content/changelog/YYYY-MM-DD-slug.mdx`. Carbon has no versions, so `date` is the
+ordering key and the filename's date must match the frontmatter's. Entries land roughly
+every two weeks.
+
+### 3. Write it
+
+Frontmatter, then a lead, then one `##` per feature. The failure mode to avoid is the
+100-word unbroken paragraph with no links — see the rule for the full format, but in short:
+
+- `description` — **15–20 words**. It is the whole feed row.
+- Lead with why, then what, in one or two sentences before the first `##`.
+- One `##` per feature, 1–3 sentences, under ~60 words.
+- **Link each feature to its reference page on first mention.** There are ~94 pages under
+ `docs/content/docs/reference/`; check for one before writing a bare noun.
+- Say where it lives (`Automate → Workflows`) only if you have verified the path.
+- `<Accordion title="Improvements">` / `"Fixes"` last, one line per bullet.
+- No em dashes.
+
+### 4. Generate the thumbnail
+
+```bash
+cd docs && pnpm generate:changelog-thumbnails # all entries
+cd docs && pnpm generate:changelog-thumbnails <slug> # just the new one
+```
+
+The motif is derived from the **title**: whichever motif keyword appears earliest wins,
+because a changelog title leads with its headline feature. Layout detail is varied by a
+hash of the slug, so two entries sharing a motif do not come out identical, and a rerun
+is byte-identical. The script also stamps `image:` into the frontmatter when missing.
+
+If a new entry's subject has no motif, add one to `MOTIFS` in
+`docs/scripts/generate-changelog-thumbnail.mjs` alongside a drawing function — do not
+hand-author a one-off SVG, or the set drifts out of the house style.
+
+### 5. Verify — all four surfaces
+
+```bash
+cd docs
+pnpm typecheck
+curl -s localhost:3002/changelog/rss.xml | grep -c '<item>' # every entry renders
+```
+
+Every internal link must resolve; a `/docs/...` path with no file 404s silently in the
+feed *and* in the newsletter:
+
+```bash
+cd docs && for l in $(grep -oh "](/docs/[^)]*)" content/changelog/*.mdx \
+ | sed 's|](/docs/||;s|)||' | sort -u); do
+ [ -f "content/docs/$l.mdx" ] || [ -f "content/docs/$l/index.mdx" ] \
+ || echo "MISSING $l"; done
+```
+
+Then look at `/changelog` and the permalink in a browser.
+
+## Gotchas
+
+- **Any MDX component an entry uses needs a plain-HTML stand-in** in
+ `docs/lib/changelog-feed-components.tsx`. Feed readers run no components; one that is
+ missing renders `undefined` and **fails the build**, deliberately — a newsletter that
+ silently drops a section is worse than a red build.
+- `Callout` here is the Reference one (`type`/`title`/`children`), not the Guides variant
+ with `tone`/`badge`.
+- The newsletter dispatcher reads the RSS feed, so a malformed entry reaches subscribers.
+ Check the feed before considering the entry done.
+- Nothing sends `carbon/changelog-dispatch` automatically; publishing the entry is not
+ the same as sending the newsletter.
diff --git a/AGENTS.md b/AGENTS.md
index 0fe17d3f63..9a4c1d0ee4 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -104,8 +104,11 @@ IMPORTANT: Before any research or coding, match the task to this table. A single
| **Infrastructure** | |
| File uploads, images, HEIC, MIME types, CAD formats | `packages/files/AGENTS.md` |
| PDF generation | `.claude/rules/pdf-generation-patterns.md` + `packages/documents/AGENTS.md` |
+| Email templates (notification / transactional / broadcast design) | `.claude/rules/email-design.md` + `packages/documents/AGENTS.md` |
| Printing system | `.claude/rules/printing-system.md` + `packages/printing/AGENTS.md` |
| CSV import/export | `.claude/rules/csv-import-system.md` + `.claude/rules/table-csv-export.md` |
+| Changelog entries (authoring + the feed) | `.claude/rules/changelog-authoring.md` |
+| Writing/shipping a changelog entry (end to end) | `.claude/skills/changelog-entry/SKILL.md` |
| Billing / Stripe | `.claude/rules/billing-system.md` + `packages/stripe/AGENTS.md` |
| Deployment (SST) | `.claude/rules/sst-deployment-infrastructure.md` |
| Audit log system | `.claude/rules/audit-log-system.md` |
diff --git a/apps/erp/app/components/ChangelogPanel.tsx b/apps/erp/app/components/ChangelogPanel.tsx
new file mode 100644
index 0000000000..fcfb50290a
--- /dev/null
+++ b/apps/erp/app/components/ChangelogPanel.tsx
@@ -0,0 +1,81 @@
+import { Badge, Button, IconButton } from "@carbon/react";
+import { Trans, useLingui } from "@lingui/react/macro";
+import { AnimatePresence, motion } from "framer-motion";
+import { LuExternalLink, LuX } from "react-icons/lu";
+import type { ChangelogPanelEntry } from "~/modules/account";
+import { path } from "~/utils/path";
+
+type ChangelogPanelProps = {
+ entry: ChangelogPanelEntry | null;
+ isOpen: boolean;
+ onDismiss: () => void;
+};
+
+// The link opens the entry's own page. path.to.changelogEntry carries the instance
+// hint the docs Subscribe popover reads, which now sits on every changelog page.
+export default function ChangelogPanel({
+ entry,
+ isOpen,
+ onDismiss
+}: ChangelogPanelProps) {
+ const { t } = useLingui();
+ if (!entry) return null;
+
+ return (
+ <AnimatePresence mode="wait">
+ {isOpen && (
+ <motion.div
+ key={entry.guid}
+ initial={{ opacity: 0, y: 20, scale: 0.95, filter: "blur(4px)" }}
+ animate={{ opacity: 1, y: 0, scale: 1, filter: "blur(0px)" }}
+ exit={{ opacity: 0, y: 10, scale: 0.95, filter: "blur(4px)" }}
+ transition={{ duration: 0.3, ease: "easeOut" }}
+ className="fixed bottom-4 right-4 w-[calc(100vw-2rem)] max-w-[380px] rounded-lg border bg-background shadow-lg z-40 overflow-hidden"
+ >
+ <div className="px-4 pt-4 pb-3 space-y-2">
+ <div className="flex items-center justify-between">
+ <Badge variant="blue" className="h-5 px-1.5 text-[10px]">
+ <Trans>New</Trans>
+ </Badge>
+ <IconButton
+ aria-label={t`Close`}
+ icon={<LuX />}
+ variant="ghost"
+ size="sm"
+ className="-mr-2 -mt-1"
+ onClick={onDismiss}
+ />
+ </div>
+ <h3 className="text-sm font-semibold tracking-tight">
+ {entry.title}
+ </h3>
+ {entry.description && (
+ <p className="text-xs text-muted-foreground">
+ {entry.description}
+ </p>
+ )}
+ </div>
+
+ <div className="px-4 pb-3.5 flex items-center justify-end gap-2">
+ <Button variant="secondary" size="sm" onClick={onDismiss}>
+ <Trans>Dismiss</Trans>
+ </Button>
+ <Button
+ size="sm"
+ rightIcon={<LuExternalLink />}
+ onClick={() =>
+ window.open(
+ path.to.changelogEntry(entry.slug),
+ "_blank",
+ "noopener,noreferrer"
+ )
+ }
+ >
+ <Trans>Changelog</Trans>
+ </Button>
+ </div>
+ </motion.div>
+ )}
+ </AnimatePresence>
+ );
+}
diff --git a/apps/erp/app/hooks/useChangelogPanel.ts b/apps/erp/app/hooks/useChangelogPanel.ts
new file mode 100644
index 0000000000..8a69502e8a
--- /dev/null
+++ b/apps/erp/app/hooks/useChangelogPanel.ts
@@ -0,0 +1,37 @@
+import { useRouteData } from "@carbon/react";
+import { useFetcher } from "react-router";
+import type { ChangelogPanelEntry } from "~/modules/account";
+import { changelogFlagKey } from "~/modules/users";
+import { path } from "~/utils/path";
+import { useUser } from "./useUser";
+
+// Dismissing sets the user flag `changelog:<slug>`, so it holds on every device;
+// a newer entry has a new slug and shows again.
+export function useChangelogPanel(): {
+ entry: ChangelogPanelEntry | null;
+ isOpen: boolean;
+ dismiss: () => void;
+} {
+ const { flags } = useUser();
+ const data = useRouteData<{ changelog?: ChangelogPanelEntry | null }>(
+ path.to.authenticatedRoot
+ );
+ const entry = data?.changelog ?? null;
+ const flagKey = entry ? changelogFlagKey(entry.slug) : null;
+ const fetcher = useFetcher({ key: "changelog-dismiss" });
+
+ const isPendingDismiss =
+ flagKey !== null && fetcher.formData?.get("flag") === flagKey;
+ const isDismissed =
+ isPendingDismiss || (flagKey !== null && flags[flagKey] === true);
+
+ const dismiss = () => {
+ if (!flagKey) return;
+ fetcher.submit(
+ { intent: "flag", flag: flagKey, value: "true" },
+ { method: "POST", action: path.to.acknowledge }
+ );
+ };
+
+ return { entry, isOpen: entry !== null && !isDismissed, dismiss };
+}
diff --git a/apps/erp/app/modules/account/account.service.ts b/apps/erp/app/modules/account/account.service.ts
index 3782bfac33..3ce87e4dc0 100644
--- a/apps/erp/app/modules/account/account.service.ts
+++ b/apps/erp/app/modules/account/account.service.ts
@@ -2,6 +2,35 @@ import type { Database } from "@carbon/database";
import type { SupabaseClient } from "@supabase/supabase-js";
import { sanitize } from "~/utils/supabase";
+export type ChangelogPanelEntry = {
+ guid: string;
+ slug: string;
+ title: string;
+ description: string | null;
+};
+
+// The newest entry in the dispatch ledger (service-role only). `slug` is the
+// last segment of the guid permalink and keys the dismissal flag.
+export async function getChangelogPanelEntry(
+ serviceRole: SupabaseClient<Database>
+): Promise<ChangelogPanelEntry | null> {
+ const latest = await serviceRole
+ .from("changelogDispatch")
+ .select("guid, title, description")
+ .order("dispatchedAt", { ascending: false })
+ .limit(1)
+ .maybeSingle();
+ if (!latest.data?.title) return null;
+ const slug = latest.data.guid.split("/").filter(Boolean).pop() ?? "";
+ if (!slug) return null;
+ return {
+ guid: latest.data.guid,
+ slug,
+ title: latest.data.title,
+ description: latest.data.description
+ };
+}
+
export async function getNotificationPreferences(
client: SupabaseClient<Database>,
userId: string,
diff --git a/apps/erp/app/modules/agent/kb/changelog/2026-03-31-time-clock-and-quality-dashboard.md b/apps/erp/app/modules/agent/kb/changelog/2026-03-31-time-clock-and-quality-dashboard.md
new file mode 100644
index 0000000000..a19368b391
--- /dev/null
+++ b/apps/erp/app/modules/agent/kb/changelog/2026-03-31-time-clock-and-quality-dashboard.md
@@ -0,0 +1,24 @@
+# Employee time clock and the Quality dashboard
+
+> Clock in and out with breaks, flags, and overtime; see quality at a glance on a new dashboard; add non-taxable add-ons to quotes, orders, and invoices.
+
+Employees can now clock in and out in Carbon, with breaks, flags, and overtime tracked on the time card. The Quality dashboard brings issues, inspections, and open actions onto one screen. Quotes, sales orders, and sales invoices accept non-taxable add-ons.
+
+- Converting a quote to a sales order generates and attaches the sales order PDF.
+- The sales order summary shows invoiced and paid amounts.
+- The item master gained an exploded bill of materials view.
+- BOM exports include cost estimates, including the cost of subassemblies.
+- Demand forecast is shown on the inventory table, and planning tables sort by quantity to order.
+- Tracked entities can be updated and deleted, and you're warned if you forget to issue a tracked part.
+- Shipment lines accept a readable id.
+- Inventory adjustments carry a comment.
+- Drawers have a new floating look.
+- Academy: new Issues and Gauges & Calibrations videos.
+
+- Invoicing partial shipments no longer miscounts.
+- Quote lines take the operation minimum cost from the method operation.
+- Notes, assignee, and custom fields respect record locks.
+- The payment dropdown is disabled by invoice status and permissions.
+- Deactivating and reactivating a user no longer poisons the permissions cache.
+- Inventory quantities no longer show duplicate rows across companies.
+- The issues view's containment status column renders correctly.
diff --git a/apps/erp/app/modules/agent/kb/changelog/2026-04-14-passkeys.md b/apps/erp/app/modules/agent/kb/changelog/2026-04-14-passkeys.md
new file mode 100644
index 0000000000..5e482849dd
--- /dev/null
+++ b/apps/erp/app/modules/agent/kb/changelog/2026-04-14-passkeys.md
@@ -0,0 +1,26 @@
+# Carbon MCP server, passkeys, and Console mode
+
+> Connect AI clients to Carbon over MCP, sign in without a password, run the shop floor in Console mode, and use Carbon in Hindi, French, Polish, Portuguese, and Russian.
+
+The Carbon MCP server lets Claude, Cursor, and other AI clients work with your data through Carbon's tools. Passkeys arrive for passwordless sign-in. Register one from your account, sign in with Face ID, Touch ID, or a security key, and rename or remove passkeys you no longer use. Console mode runs a shared shop-floor device without a personal session.
+
+## Languages
+
+Carbon is now available in Hindi, French, Polish, Portuguese, and Russian, and the login page is translated too.
+
+- Method types are now named for what they do: Pull from Inventory, Purchase to Order, and Make to Order (previously Pick, Buy, Make).
+- CSV import tools.
+- A Recalculate unit cost button on the item master.
+- Purchased lead time is updated from a weighted yearly average.
+- API key expiration dates are validated more strictly.
+- Active time cards count toward duration calculations.
+- Risk updates carry more detail.
+
+- Markup is calculated correctly on purchased quoted parts.
+- External notes show on the digital quote.
+- Purchasing RFQ property updates save correctly.
+- Audit logs that went missing are recorded again.
+- Line-item document errors are handled instead of failing the page.
+- Onshape sync tolerates a missing item.
+- Faster dialogs and forms.
+- A cross-site scripting vulnerability was closed.
diff --git a/apps/erp/app/modules/agent/kb/changelog/2026-04-28-inventory-storage.md b/apps/erp/app/modules/agent/kb/changelog/2026-04-28-inventory-storage.md
new file mode 100644
index 0000000000..3af71beccb
--- /dev/null
+++ b/apps/erp/app/modules/agent/kb/changelog/2026-04-28-inventory-storage.md
@@ -0,0 +1,26 @@
+# Inbound inspections, pricing rules, and storage units
+
+> Inspect what you receive, price by rule, and model your warehouse as storage units and types.
+
+Inbound inspections put received goods through an inspection before they're available. Pricing rules set prices by rule instead of by hand. Inventory storage has been rebuilt around storage units and storage types, so a location's bins, shelves, and racks are modeled the way your warehouse works.
+
+- Negative adjustments for batch- and serial-tracked parts.
+- Duplicate a pricing list.
+- Due dates can be edited inline on schedule job cards, and empty work centers can be hidden.
+- Receipts can be created when line items have no price.
+- Purchase order delivery dates are editable regardless of status.
+- Purchase invoice status "Submitted" is now "Open".
+- The BOM combobox reveals its dropdown on hover, sizes to its content, and shows tooltips for truncated names.
+- The language dropdown lists every available locale.
+- Audit configuration can name the fields recorded on create.
+- MCP: search and call tools.
+
+- Active make methods can no longer be overwritten.
+- Backflushing serial parts includes their children.
+- Serial and batch tracked entities are restored on job creation.
+- Customer part ids are deduplicated on quotes and RFQs.
+- Active quotes no longer auto-close.
+- Jobs auto-complete correctly, and method type reads Make to Order rather than Make.
+- Purchase invoice line prices update on the right trigger.
+- Sign-in failures show consistent messages.
+- Paperless Parts no longer overwrites data.
diff --git a/apps/erp/app/modules/agent/kb/changelog/2026-05-12-item-constraint-rules.md b/apps/erp/app/modules/agent/kb/changelog/2026-05-12-item-constraint-rules.md
new file mode 100644
index 0000000000..7283cfaec7
--- /dev/null
+++ b/apps/erp/app/modules/agent/kb/changelog/2026-05-12-item-constraint-rules.md
@@ -0,0 +1,27 @@
+# Multi-entity accounting, storage rules, and shelf life
+
+> Run several legal entities in one company group, guard inventory transactions with storage rules, and track shelf life.
+
+Multi-entity accounting lets a company group run several legal entities with their own books. A `docs/reference/storage-rules` runs when an inventory transaction posts: it checks the line against a condition you define and either blocks the transaction or warns and lets the user continue; rules attach to items or work centers. Shelf life is tracked on items and batches.
+
+## Traceability explorer, rebuilt
+
+The traceability explorer has been rebuilt for large genealogies, and dates across the app now follow your locale.
+
+- Incoterms and EORI numbers.
+- An Accounting settings page; supplier approval moved out of company settings.
+- Job materials can be backflushed.
+- Plan upgrade banners show where a feature needs the Business plan.
+- The configurator can eliminate a part or process with an empty value.
+- Language selection moved to the avatar menu.
+- Stripe invoice notifications, including invoice sent.
+
+- Files can be uploaded and dates changed on documents in any status.
+- Supplier approval no longer fails.
+- RFQ-to-quote flow fixes.
+- Shipment lines validate batch input, check expiry, and no longer go stale.
+- Receipts, shipments, and stock transfers only list Draft items when filtering by tracking status.
+- Shelf-life inventory adjustments follow the right path.
+- Traceability paths resolve correctly.
+- Risks for a source entity are matched with AND logic.
+- Job completion handles a split-duplicated tracked entity and surfaces the real error.
diff --git a/apps/erp/app/modules/agent/kb/changelog/2026-05-26-shelf-life-history.md b/apps/erp/app/modules/agent/kb/changelog/2026-05-26-shelf-life-history.md
new file mode 100644
index 0000000000..7ca03a375d
--- /dev/null
+++ b/apps/erp/app/modules/agent/kb/changelog/2026-05-26-shelf-life-history.md
@@ -0,0 +1,25 @@
+# Fixed assets, redesigned PDFs, and menu customization
+
+> Track fixed assets, every PDF redesigned, reorder your sidebar, and keep a shelf-life history.
+
+Fixed assets arrive in accounting. Every PDF has been redesigned, with further improvements to the purchasing documents. The sidebar can be customized, so you can reorder modules and hide the ones you don't use.
+
+- Shelf-life history and an inventory history menu.
+- Reorder line items on documents.
+- Filter the inventory table by storage unit.
+- Expand or collapse every level of a BOM explorer at once.
+- Traceability search disambiguates readable ids with job and tracking context.
+- Hide empty work centers on the schedule.
+- Audit logs snapshot related records.
+- New fields on CSV imports.
+- Email notifications are a plan feature, shown as such in settings.
+- Onboarding's plan selection and model viewer were refined.
+- Academy: Historical Costs, Purchase Invoices, Purchasing Planning, and Supplier Pricing videos.
+
+- Make-to-order jobs issue to inventory and create cost of goods sold on shipment.
+- Unlinking a job from a sales order asks for confirmation.
+- Released job material operations validate correctly.
+- The BOM explorer popover no longer disappears too quickly.
+- Realtime reconnects when the tab becomes visible again.
+- Notification links validate job parameters.
+- Sidebar scrollbars fixed.
diff --git a/apps/erp/app/modules/agent/kb/changelog/2026-06-09-rework-and-ballooning.md b/apps/erp/app/modules/agent/kb/changelog/2026-06-09-rework-and-ballooning.md
new file mode 100644
index 0000000000..000e9beeeb
--- /dev/null
+++ b/apps/erp/app/modules/agent/kb/changelog/2026-06-09-rework-and-ballooning.md
@@ -0,0 +1,25 @@
+# Rework, Purchasing Planning 2.0, and ballooning diagrams
+
+> Send serial and batch parts through rework, a rebuilt purchasing planning, ballooned inspection diagrams, and MCP 2.0 with OAuth.
+
+Serial- and batch-tracked parts can be sent through rework. Purchasing Planning 2.0 rebuilds the buying workspace. Quality gained ballooning diagrams for inspections, and an operator can raise a quality issue directly from MES. MCP 2.0 adds OAuth sign-in for AI clients.
+
+- Approvals: a lower-tier notification, a maximum amount, and notifications for rules with lower amounts.
+- Sales orders can be cancelled.
+- A post-login company picker for people in more than one company.
+- Attachments on purchase orders, and supplier part numbers on purchase order lines.
+- The sales order number on invoice PDFs.
+- A custom markup percentage in the quote line pricing dropdown.
+- Manually scheduled operations that the scheduler leaves alone.
+- Subassembly items show their item properties.
+- Location shown on the people table.
+- Long descriptions are editable again.
+
+- Storage rule messages name the storage unit instead of showing an id, and conditions accept value and label.
+- Rework quantities are subtracted on Complete all, and rework respects row-level security.
+- Negative adjustments work on serial items with legacy stock.
+- Dead tax fields on invoice totals fixed, and the upper bound on pricing approval corrected.
+- The job traveler PDF shows the correct time units.
+- List-type custom field values render in table columns.
+- Get Method respects checkbox selections when copying make methods.
+- Supplier and customer ids are consistent.
diff --git a/apps/erp/app/modules/agent/kb/changelog/2026-06-23-supersession-and-method-import.md b/apps/erp/app/modules/agent/kb/changelog/2026-06-23-supersession-and-method-import.md
new file mode 100644
index 0000000000..d61d3b90b4
--- /dev/null
+++ b/apps/erp/app/modules/agent/kb/changelog/2026-06-23-supersession-and-method-import.md
@@ -0,0 +1,28 @@
+# Picking lists, label printing, and item supersession
+
+> Pick against a list, print labels, phase out a part in favor of its successor, import methods from CSV, and customize document templates.
+
+Picking lists turn demand into a pick against real storage units. Label printing ships. Item supersession records that a part is being phased out and which successor replaces it, so planning and job creation pick up the change. Bills of materials and bills of process can be imported from CSV, and document templates now have a customizer.
+
+- Duplicate a purchase order.
+- Inbound inspection for non-serial tracked items.
+- Sourcing type is an item-level property.
+- The import flow explains the Default row, clarifies Tracking Type, adds an optional unit cost, and lets value mappings be cleared.
+- The customer portal page was redesigned, with filtering.
+- Safety stock on the item planning chart, with clearer axis labels.
+- Field label tooltips, and tooltips for RFQ dates; the RFQ "Expiration Date" is now "Due Date".
+- Delete a 3D model from the viewer; the storage units tree opens expanded.
+- Copy the company id from company settings.
+- Document headings and body text follow the document theme.
+- Turkish translation.
+- MCP and self-hosting documentation.
+
+- CSV export respects the current saved view.
+- Purchase price updates on the invoice.
+- The packing slip is correct for warehouse transfer shipments.
+- Picking list line UI fixes.
+- Popover dropdowns scroll inside drawers and dialogs.
+- The employee group select pulls employees again.
+- Null unit costs no longer error; import writes unit cost and clears per-row errors.
+- Stale non-conformance descriptions refresh.
+- Label templates print correctly, including in the preview.
diff --git a/apps/erp/app/modules/agent/kb/changelog/2026-07-07-period-close-and-budgeting.md b/apps/erp/app/modules/agent/kb/changelog/2026-07-07-period-close-and-budgeting.md
new file mode 100644
index 0000000000..d81bf858e9
--- /dev/null
+++ b/apps/erp/app/modules/agent/kb/changelog/2026-07-07-period-close-and-budgeting.md
@@ -0,0 +1,28 @@
+# Period closing, AR/AP payments, and company backups
+
+> Close accounting periods, set budgets, reconcile bank statements, record receivable and payable payments, and back up or restore a whole company.
+
+Accounting gained period closing, budgeting, and bank reconciliation, with drill-down from any account into the entries behind it. AR/AP payments record what customers pay and what you pay suppliers. Company backups export everything a company owns and restore it, with real progress and faster downloads.
+
+## Onboarding, revamped
+
+Onboarding was rebuilt around the Implementation Hub and a Setup Map, and a new company can start from demo data.
+
+- Manufacturer Part Number on items.
+- An aggregated stock movements view.
+- Document templates support registration numbers, and PDFs auto-fill.
+- Supersession shows on material, tool, and consumable pages, with lifecycle badges and mode help.
+- Shift-select in tables, better inline editing, and CSV exports that respect the current view.
+- Download links for files.
+- Job order status tracks supply jobs and material shortfalls.
+- Self-hosting: auth providers are configurable from .env.
+
+- Quote-to-order financials are derived server-side, and quote acceptance is guarded against replay and stale status.
+- Invoice tax, the WIP ledger, editing production events, and dimension labels fixed.
+- Invoicing works without accounting enabled.
+- A job's shipped quantity is no longer overwritten on completion.
+- Negative adjustment errors surface in the modal.
+- File previews are authorized by company.
+- Backup restore hardening, and transient MRP tables are excluded from backups.
+- Auto-completed job operations record who completed them.
+- The number input allows direct typing.
diff --git a/apps/erp/app/modules/agent/kb/changelog/2026-07-21-inventory-valuation.md b/apps/erp/app/modules/agent/kb/changelog/2026-07-21-inventory-valuation.md
new file mode 100644
index 0000000000..74ce82cebb
--- /dev/null
+++ b/apps/erp/app/modules/agent/kb/changelog/2026-07-21-inventory-valuation.md
@@ -0,0 +1,32 @@
+# Change notices
+
+> Draft an engineering change against real methods, review it as a diff, and release it so planning supersedes the versions it replaces. Plus inventory valuation, Service items, and assembly instructions.
+
+A `docs/reference/change-orders` groups the parts whose designs are changing, revises each one on a hidden draft, and releases them together. It answers what changed, who owns it, and what the new version supersedes, without touching a live method until release. You pick the affected items, edit each one's real bill of materials and bill of process inside the notice, review it as a diff with new part properties highlighted, and link issues to it. Change notices live under Items → Change notices.
+
+## Inventory valuation and Service items
+
+The inventory valuation report ties on-hand stock to the ledger, and inventory adjustments post to the GL. Service is now a first-class item type. The accounting period close has a full lifecycle with a close checklist and posted-record immutability.
+
+- Assembly instructions on items.
+- Short-close purchase order lines, with partial goods-receipt visibility.
+- MES suggests a batch on issue and returns unused picks when a job completes.
+- Overhead absorption and account defaults improvements, with draft journals excluded from reports.
+- Raw materials and finished goods accounts.
+- Self-serve enrollment in the Implementation Hub.
+- A faster CAD pipeline with a progressive 3D viewer.
+- Top-level external notes are included in document emails.
+- Detail pages show the entity id in the breadcrumb.
+- Korean translation.
+- Academy: Engineering Change Orders video.
+
+- GAAP-correct journal entries for fixed asset registration and disposal.
+- Purchase price variance is no longer double-counted; the GL and cost subledger move together.
+- Default markup no longer overwrites set quote-line prices.
+- Subassemblies are scheduled by their item lead time.
+- Planning reads top-level demand projections.
+- Invoicing quantities are short-close aware.
+- Customer reference, salesperson, and engineering contact carry through to sales orders.
+- Selling a fixed asset no longer requires a method type.
+- The first tag can be created when none exist.
+- MES add-row suggestions prefer the pick-method order and clamp batch quantity.
diff --git a/apps/erp/app/modules/agent/kb/changelog/2026-08-04-stock-movement-corrections.md b/apps/erp/app/modules/agent/kb/changelog/2026-08-04-stock-movement-corrections.md
new file mode 100644
index 0000000000..1639872729
--- /dev/null
+++ b/apps/erp/app/modules/agent/kb/changelog/2026-08-04-stock-movement-corrections.md
@@ -0,0 +1,32 @@
+# Carbon agent, stock movement corrections, and notification preferences
+
+> An AI agent inside Carbon, corrections for any posted stock movement, per-topic notification preferences, and per-item serial number sequences.
+
+The Carbon agent answers questions and takes actions inside the app. Any posted stock movement can be corrected with a linked correction row, replacing count rectification. Notification preferences are per user and per topic, with email and Slack opt-outs. Serial number sequences are configurable per item.
+
+## Change notices and assembly instructions
+
+Change notices gained an implementation lock with reopen and links to Linear tasks; assembly instructions are versioned and surfaced in change notice diffs.
+
+- MES: material picking with opt-in pre-select and an incomplete-pick policy, a Load Preview on the job-operation model tab, and NCR containment inspection steps created as needed in the assembly view.
+- Shop-floor assembly and inspection execution.
+- An opt-in materials section on the job traveler PDF, and total rows on the Estimates vs Actual card.
+- CSV bulk import for material properties, and the combined parts-with-methods import is back.
+- Released drawings and CAD models upload from Onshape.
+- Line-item shipping cost on the purchase order PDF, with corrected document totals.
+- Quick-filter toggles on inventory count lines.
+- Audit logs show related records and mark empty values.
+- Backups are available to non-internal users on self-hosted installs.
+- The accounting module is internationalized.
+- Academy: redesigned, with a Work Instructions and Process Types lesson.
+
+- Jobs cannot be created with zero quantity, and a job can re-link to a sales order line.
+- Receipts: posting is blocked on voided receipts and the Pending transition is atomic.
+- Bin-to-bin batch transfers no longer consume the lot; the transfer wizard was redesigned.
+- Invoice due dates recompute when the issue date or payment term changes.
+- MES: fractional quantities in the operation quantity modal, expired lots excluded from FEFO suggestions, picked remainders return to the actual pick bin, and work instructions render step images.
+- Passkey sign-in fails safely on a company lookup error and shows the company picker for multi-company users.
+- Digital quote lines can be deselected and removed wherever they are selectable.
+- Line tax percent shows two decimals; the job traveler BOM header stays attached across page breaks.
+- Notification recipients who left the company are dropped.
+- Onshape OAuth failures are surfaced on the integrations page.
diff --git a/apps/erp/app/modules/agent/kb/changelog/2026-08-18-accounting-sync-engine.md b/apps/erp/app/modules/agent/kb/changelog/2026-08-18-accounting-sync-engine.md
new file mode 100644
index 0000000000..78bf0cd70c
--- /dev/null
+++ b/apps/erp/app/modules/agent/kb/changelog/2026-08-18-accounting-sync-engine.md
@@ -0,0 +1,34 @@
+# Automation workflows
+
+> Build automations on a canvas from a trigger, conditions, and steps that notify people, update records, or call an outside service. Plus accounting sync for Xero, QuickBooks Online, and Rillet, financial reports, and scrap.
+
+A `docs/reference/workflows` watches for something happening in Carbon and then does something about it: notify the account manager when a sales order changes hands, open an issue when a job is put on hold, or call your own service when a shipment is posted. You build one on a canvas under Automate → Workflows and press Publish. Steps are cards you connect by their handles, so one trigger can fan out into branches. Every run is recorded step by step in `docs/reference/workflow-runs`.
+
+## Accounting sync and financial reports
+
+Carbon can sync accounting data to Xero, QuickBooks Online, and Rillet through one multi-provider sync engine. A financial reports module arrives with it. Multi-entity companies get a capture-driven intercompany elimination engine: intercompany invoices are posted, matched, and eliminated automatically, and consolidated reports show the group without double-counted internal trade.
+
+## Scrap and unscrap
+
+Scrap serials and subcomponents from MES or stock from the ERP, with a scrap-reason dimension; unscrap restores a scrapped part at its original cost.
+
+- TOTP two-factor authentication, with org-level enforcement.
+- MES work center displays, and board and list views for the assigned-to-me page.
+- Business dates follow the company and location timezones, with a shared date-time control and a searchable timezone picker.
+- Picked-material return timing (at job or operation), and batch splits keep the parent's identity.
+- An ITAR certification system covers entity and user certifications, with hardened invites.
+- A platform-wide numeric precision and formatting standard. Per-unit prices keep the digits they were typed with.
+- Search modal filter chips are ordered by likely use.
+- The guides carry real product screenshots.
+
+- Quote line prices are rewritten in a transaction, preserve shipping cost, and an empty rewrite is a no-op.
+- Base-currency pricing shows in the base currency on quotes and sales order lines; supplier quotes compare in the base currency.
+- Sales order totals no longer collapse equal line amounts.
+- Invoice due dates handle End of Month and Day of Month payment terms and populate from the payment term on posting.
+- Picking lists honor item supersession, and the default bin is read for the right item.
+- Item quantities update in real time, alongside MRP correctness fixes; planning scrap math and MRP double-netting corrected.
+- Schedule board updates commit on drop, and pre-assigned work centers survive a reschedule.
+- MES: the serial picker only shows for serial parts, multiple batches can be unconsumed, and job operation files are reachable on mobile.
+- Issues appear in global search; duplicate issue type names are prevented.
+- Change notice notifications go to assignees instead of the whole company.
+- Audit log diffs show display names instead of raw ids.
diff --git a/apps/erp/app/modules/agent/kb/changelog/2026-09-04-finite-capacity-scheduling.md b/apps/erp/app/modules/agent/kb/changelog/2026-09-04-finite-capacity-scheduling.md
new file mode 100644
index 0000000000..9ec27df253
--- /dev/null
+++ b/apps/erp/app/modules/agent/kb/changelog/2026-09-04-finite-capacity-scheduling.md
@@ -0,0 +1,28 @@
+# Finite-capacity scheduling
+
+> The scheduler now plans against real work-center capacity, with ability-gated operators and an explainable Gantt.
+
+The `docs/reference/scheduling` now plans against real capacity instead of assuming infinite machines and people. Scheduling an operation reserves capacity on its work center, operators are gated by the abilities a job operation requires, and the Gantt explains its placements, so you can see why an operation landed where it did instead of guessing.
+
+## Enterprise SAML SSO
+
+Carbon now supports SAML single sign-on, so your team can sign in through your identity provider. Account linking is provider-agnostic, and the configuration lives in Settings → Security. Two-factor enforcement is also now available on the Business plan.
+
+## Platform exchange rates with per-company overrides
+
+Currency exchange rates are now managed platform-globally, with per-company overrides when your company needs to pin its own rate. The chart of accounts also gained an opening-balances tool for bringing existing books into Carbon.
+
+- Jobs can copy their method from another job, with a version picker for choosing which method revision to source.
+- A BOM-level replenishment system and purchasing units of measure.
+- API keys can opt in to an accounting delete scope.
+- A refreshed app shell for ERP and MES with an inset, floating layout, plus responsive mobile navigation.
+- CSV import for storage units, with validation that rejects cross-location and name-colliding rows.
+- Item IDs may now be lowercase, and chart-of-accounts account mapping covers the full chart.
+- Purchase order PDFs show the company EORI number below the VAT number.
+- Onboarding now presents the Starter, Business, and Enterprise plans.
+
+- Item supersession swaps now resolve correctly across every job-creation flow, so a phased-out part's successor is substituted consistently.
+- The schedule no longer reopens finished operations when a location's schedule is regenerated.
+- Items with inventory or cost history can no longer be deleted out from under their records.
+- Posting a purchase invoice no longer marks it paid.
+- MES shows the item revision in the operation header, and an unconverted 3D model renders as a slide instead of a load error.
diff --git a/apps/erp/app/modules/agent/kb/changelog/2026-09-18-returns-batching-and-the-carbon-api.md b/apps/erp/app/modules/agent/kb/changelog/2026-09-18-returns-batching-and-the-carbon-api.md
new file mode 100644
index 0000000000..53657eb512
--- /dev/null
+++ b/apps/erp/app/modules/agent/kb/changelog/2026-09-18-returns-batching-and-the-carbon-api.md
@@ -0,0 +1,42 @@
+# Returns, operation batching, and the Carbon API
+
+> Customer RMAs and supplier returns, job operations that run as one batch across ERP and MES, every service operation reachable over plain HTTP, and keyboard shortcuts everywhere.
+
+Returns now have a home of their own. A `docs/reference/rmas` authorizes what a customer may send back. Its lines can point at the sales order, shipment, or invoice lines they reverse, and the picker only offers quantities that have actually shipped and have not already been authorized. Receiving an RMA goes through the same receipts flow as a purchase order, and a customizable PDF is generated when the RMA is confirmed. `docs/reference/supplier-returns` work the other way round: send received goods back to a supplier, keeping serial or batch identity, claim the credit, and raise a replacement purchase order.
+
+## Job operation batching
+
+Operations from several jobs can now run together as one `docs/reference/batching`: a heat-treat load, a plating tank, an oven cycle. Mark a process as batchable, say whether members run sequentially or simultaneously, and set compatibility rules and a work-center capacity limit. Batches are created, reviewed, released, moved, and dissolved from the Batches list, which also has a bulk "Release N batches" action. Each batch prints a load sheet and appears collapsed on the schedule boards, the job lists, and the MES operation view. Releasing a batch schedules it as a single capacity reservation, and completing it shares one timer across its members with time and cost allocated proportionally.
+
+## The Carbon API
+
+All 1,481 of Carbon's service operations are now reachable at `POST /api/v1/{module}/{operation}`, with an OpenAPI 3 spec at `/api/v1/openapi.json`. The [API docs](/api) have been rebuilt around it. The MCP server, the in-app agent, and workflow actions all run through this same layer now, so the per-operation scope check on an API key is enforced once, the same way, for every caller.
+
+## Keyboard shortcuts everywhere
+
+Press `?` on any page to see every shortcut available there. Save any form with Cmd+Enter (Ctrl+Enter on Windows), press `n` to add a record on a list page, `g` then a letter to jump to a module, and Space to start or pause an operation on the shop floor. Buttons show a small keycap badge for their shortcut, with the right symbol for your platform.
+
+- `docs/reference/import-export` for quotes (whole quotes with lines, headers only, or lines added to existing quotes), plus six new import types: services, units of measure, item groups, storage types, scrap reasons, and departments. The BOM export now includes item attributes, the parts export is importable as-is, and leaving an import in progress asks before discarding it.
+- A **Transfer** `docs/reference/kanban` type alongside Buy and Make: scanning it creates a stock transfer from one storage unit to another for the kanban's quantity.
+- Early-payment discounts post as a reduction of revenue for customers and a reduction of cost for suppliers, rather than as an operating expense, the same way a credit memo already did.
+- The Rillet integration can import customers and vendors, so an invoice raised in Carbon updates the existing Rillet record instead of creating a second one. The Stripe Connect panel now walks through setup.
+- Supplier and customer records gained a Documents tab, for files that belong to the company itself rather than to any one order, and a Bank Accounts tab whose fields adapt to the country (IBAN for France, IFSC plus SWIFT for India) with checksum validation.
+- `docs/reference/sales-rules`: if-this-then-block-or-warn rules that fire when an item is added to a quote, sales order, or invoice line, built on the same engine as storage rules.
+- Item supersession's **Consume First** mode now runs end to end. Job creation, planning, picking, and consumption all agree on the old part's stock, a unit never mixes old and new parts, and you can add a predecessor from the successor's side. A supersession loop is refused instead of silently dropping both rules.
+- An ability is now created from a process and takes its name from it, so renaming the process renames the qualification.
+- The Bill of Process preview shows every step's slides, with annotation pins aligned to the image.
+- Photos taken on an iPhone are converted from HEIC to JPEG at upload, and every image upload runs through one shared pipeline.
+- MCP tools can attach files to jobs, items, opportunities, and supplier interactions.
+- Self-hosted: app email is sent over SMTP using the same `SMTP_*` variables Supabase Auth uses. An existing Resend key keeps working as a fallback.
+- Carbon Cloud: self-signup from free or disposable email domains is declined, whether by email or through Google and Outlook sign-in.
+- Pages load faster. The translation catalog is served as a cached static chunk, and the app shell no longer downloads whole tables in the browser.
+
+- Sales orders report the amount actually paid: voided invoices are excluded and partial payments count.
+- Paperless Parts webhooks are verified against the raw request body, and their errors are logged instead of swallowed.
+- Saving one integration secret no longer wipes the others.
+- A unit of measure that is still in use can no longer be deleted.
+- Completing a serial job receives exactly the quantity completed, and the outside-operation supplier is resolved from the process when a job is released.
+- Issue disposition quantities are editable, and changing an issue task's status or assignee requires the quality permission.
+- Re-inviting a user whose invitation was revoked works again, and a permission failure now shows an error instead of doing nothing.
+- Forecast rows are labelled by part rather than operation description, and an existing purchase order line is no longer listed twice in the supply and demand card.
+- Onshape sync uses the exact released part identity, and legacy invoice settlements without a document principal read correctly.
diff --git a/apps/erp/app/modules/agent/kb/changelog/2026-09-28-ramp-batch-materials-and-community-planning.md b/apps/erp/app/modules/agent/kb/changelog/2026-09-28-ramp-batch-materials-and-community-planning.md
new file mode 100644
index 0000000000..c88168ac86
--- /dev/null
+++ b/apps/erp/app/modules/agent/kb/changelog/2026-09-28-ramp-batch-materials-and-community-planning.md
@@ -0,0 +1,41 @@
+# Ramp card transactions, batch materials, and a larger community edition
+
+> Ramp card spend and AP flow into the ledger, batches share materials and plan their output lots, quotes predict lead time from the real schedule, and planning, the configurator, and accounting join the community edition.
+
+Carbon can now act as Ramp's accounting provider. Connect the integration and Carbon pushes its chart of accounts and cost centers to Ramp, then pulls card transactions, transfers, cashbacks, repayments, bills, reimbursements, and payments back. Card spend arrives as a new card transaction document (Draft, Posted, or Voided) that posts into the general ledger. Bills and payments flow through accounts payable, and Carbon's purchase orders and posted invoices go out to Ramp for bill matching. Sync Activity shows every record's outcome, and the integration panel reports its health.
+
+## Batches share materials and plan their output
+
+The second half of `docs/reference/batching`. Issuing a lot-tracked material to a batch splits it across the member jobs in proportion to what each still needs: one trip to the shelf, one consumption record per job. Output lots are planned when the batch is built, either one per member or a single combined lot, so the operator never types a lot number at completion, and a combined batch's lots are merged as soon as it completes. Operations can be removed from a batch in its drawer, and batch views show the item each operation produces rather than the job's top-level part. Jobs are still never merged: costing and genealogy stay per job throughout.
+
+## A larger community edition
+
+Material planning (MRP and the finite scheduler), the configurator rules engine, and accounting are now part of the community edition under AGPLv3. Every commercial feature's code now lives in one place, `packages/ee`, so the boundary between the editions is the boundary in the source tree, and the licensing docs name the two editions CE and EE throughout.
+
+## Quotes predict lead time from the schedule
+
+A **Predict** button on the quote line pricing grid runs the line's routing through the finite scheduler without saving anything and answers for every quantity break: **End of queue** behind released work, **Best case** with open jobs excluded, or against a **Target date**, telling you whether the line lands on time, only by expediting, or not even then. Quantity breaks now sort smallest to largest in the form, the grid, and the `docs/reference/quotes` PDF.
+
+## Demo data for everyone
+
+Every new signup now gets the "How would you like to start?" step in `docs/reference/onboarding` and can begin with an industry demo company instead of an empty one. The demo data fills every major ERP and MES screen, with documents in every status a user can reach, posted documents carry the ledger entries and stock movements real posting would create, and planning and scheduling run right after the data lands so the shop floor is scheduled, not blank.
+
+- The 3D assembly viewer can see past parts that are already fitted, with four named views (**Build**, **Focus**, **Isolate**, and **Full**) in both the ERP assembly editor and the MES shop-floor screen.
+- Each company's files now live in their own storage bucket. Backups restored into a different company come back whole: items keep their part numbers and 3D assemblies load.
+- Default accounts can be exported as CSV.
+- The Bill of Process preview shows pin labels and tool descriptions.
+- Login pages on Carbon Cloud use Vercel BotID for bot protection. Self-hosted instances choose between BotID and Turnstile with `BOT_PROTECTION`.
+- Self-hosted: setting `ADMIN_EMAIL` seeds the instance admin's account on a fresh install, and the first admin of an empty instance can reach onboarding.
+- Security hardening: tenant scoping on every path that does not go through row-level security, webhook and OAuth verification that fails closed, hashed MES console PINs (operators pin in again once after the deploy), uploaded SVG and HTML served as downloads, and cross-site request forgery protection with a report-only content security policy.
+- Page headlines are set in Hedvig Letters Serif.
+- The item sales rules card moved to the Sales tab, and unit of measure is editable on consumables and tools.
+
+- Completing a job completes its operation quantities, and estimates vs. actual shows the real completed quantity.
+- Completing a serial job from the desk no longer asks for serial numbers it already has.
+- A forced logout now says why instead of failing silently.
+- Tracked lots keep their quantities honest: values are rounded when stored so float residue never reaches the ledger, stock-transfer picks are idempotent, adjustments and counts can no longer leave a zero or negative Available lot, and the MES Complete Batch grid accepts decimals.
+- A receipt's batch-tracking status settles with its quantity, and the stock transfer wizard shows negative storage-unit balances instead of hiding them.
+- The item planning chart includes demand projections.
+- Large backup uploads no longer fail with Request Entity Too Large.
+- MES operation cards open again for companies with a copied twin, and batch numbers are searchable on the shop-floor board.
+- Material edits made over MCP save and follow the properties panel's rules.
diff --git a/apps/erp/app/modules/users/users.models.ts b/apps/erp/app/modules/users/users.models.ts
index 243ceba5f2..92ac102147 100644
--- a/apps/erp/app/modules/users/users.models.ts
+++ b/apps/erp/app/modules/users/users.models.ts
@@ -167,9 +167,18 @@ export const validUserFlags = [
"training:quality"
] as const;
+// Dismissing the What's new panel sets `changelog:<entry slug>`; open-ended
+// because entries keep being published.
+const CHANGELOG_FLAG_PREFIX = "changelog:";
+export const changelogFlagKey = (slug: string) =>
+ `${CHANGELOG_FLAG_PREFIX}${slug}`;
+
export type UserFlagKey = (typeof validUserFlags)[number];
-const userFlagKeyValidator = z.enum(validUserFlags);
+const userFlagKeyValidator = z.union([
+ z.enum(validUserFlags),
+ z.string().regex(/^changelog:[a-z0-9-]+$/)
+]);
export const userFlagValidator = z.object({
flag: userFlagKeyValidator,
diff --git a/apps/erp/app/routes/api+/mcp+/lib/mcp-blocked-tools.ts b/apps/erp/app/routes/api+/mcp+/lib/mcp-blocked-tools.ts
index 38025f3f26..b22d3d9300 100644
--- a/apps/erp/app/routes/api+/mcp+/lib/mcp-blocked-tools.ts
+++ b/apps/erp/app/routes/api+/mcp+/lib/mcp-blocked-tools.ts
@@ -3,6 +3,8 @@
* Keep this list small; add only operations that must never run via /api/mcp.
*/
export const MCP_BLOCKED_TOOL_NAMES: readonly string[] = [
+ // Needs a service-role client as its argument, which no API or MCP caller has.
+ "account_getChangelogPanelEntry",
"settings_seedCompany",
// Creating a company is an account-level operation that must not be exposed
// as an MCP tool (it would let a company-scoped token create new tenants).
diff --git a/apps/erp/app/routes/x+/_layout.tsx b/apps/erp/app/routes/x+/_layout.tsx
index ca55ded063..0653ca53a4 100644
--- a/apps/erp/app/routes/x+/_layout.tsx
+++ b/apps/erp/app/routes/x+/_layout.tsx
@@ -9,6 +9,7 @@ import {
SESSION_HEARTBEAT_MS,
SESSION_IDLE_LOCK_MS
} from "@carbon/auth";
+import { getCarbonServiceRole } from "@carbon/auth/client.server";
import { getCompanyId, setCompanyId } from "@carbon/auth/company.server";
import { userHasVerifiedTotpFactor } from "@carbon/auth/mfa.server";
import {
@@ -59,6 +60,7 @@ import {
useNavigate
} from "react-router";
import { RealtimeDataProvider } from "~/components";
+import ChangelogPanel from "~/components/ChangelogPanel";
import { PrimaryNavigation, Topbar } from "~/components/Layout";
import MfaEnrollmentRequired from "~/components/MfaEnrollmentRequired";
import SessionLockOverlay from "~/components/SessionLockOverlay";
@@ -66,7 +68,9 @@ import ShortcutHelp from "~/components/ShortcutHelp";
import { TimeCardWarning } from "~/components/TimeCardWarning";
import TrainingPanel from "~/components/TrainingPanel";
import { useIdle, usePermissions, useRecordRecentlyViewed } from "~/hooks";
+import { useChangelogPanel } from "~/hooks/useChangelogPanel";
import { useTrainingPanel } from "~/hooks/useTrainingPanel";
+import { getChangelogPanelEntry } from "~/modules/account";
import { AgentRoot } from "~/modules/agent/ui/AgentRoot";
import { getOpenClockEntry } from "~/modules/people";
import {
@@ -178,7 +182,8 @@ export async function loader({ request }: LoaderFunctionArgs) {
implementationHub,
implementationCheckStates,
implementationSignals,
- itarCertification
+ itarCertification,
+ changelog
] = await Promise.all([
getCompanies(client, userId),
getEmployeeCompanies(client, userId),
@@ -198,7 +203,9 @@ export async function loader({ request }: LoaderFunctionArgs) {
implementationHubPromise,
getImplementationCheckStates(client, companyId),
implementationSignalsPromise,
- itarCertificationPromise
+ itarCertificationPromise,
+ // Whether this user dismissed it is a user flag, read client-side.
+ getChangelogPanelEntry(getCarbonServiceRole()).catch(() => null)
]);
// Empty groups is a valid pre-onboarding state (a first-run user with no
@@ -317,6 +324,7 @@ export async function loader({ request }: LoaderFunctionArgs) {
implementationHub: implementationHub.data ?? null,
implementationCheckStates: implementationCheckStates.data ?? [],
implementationSignals,
+ changelog,
itarCertification: {
...itarCertification,
// Server-decided, never client-inferred: the gate must not be skippable
@@ -361,6 +369,7 @@ export default function AuthenticatedRoute() {
const navigate = useNavigate();
const permissions = usePermissions();
const { isOpen, training, dismiss } = useTrainingPanel();
+ const changelogPanel = useChangelogPanel();
// Session lock (NIST 3.1.10) — client idle UX only; the server enforces in
// requireAuthSession. Inert unless CONTROLLED_ENVIRONMENT.
@@ -511,6 +520,12 @@ export default function AuthenticatedRoute() {
isOpen={isOpen}
onDismiss={dismiss}
/>
+ {/* Shares the training panel's corner; training wins while open. */}
+ <ChangelogPanel
+ entry={changelogPanel.entry}
+ isOpen={changelogPanel.isOpen && !isOpen}
+ onDismiss={changelogPanel.dismiss}
+ />
<AgentRoot />
<ShortcutHelp />
{companySettings?.timeCardEnabled && (
diff --git a/apps/erp/app/routes/x+/account+/notifications.tsx b/apps/erp/app/routes/x+/account+/notifications.tsx
index f02e8490a9..d239477ecb 100644
--- a/apps/erp/app/routes/x+/account+/notifications.tsx
+++ b/apps/erp/app/routes/x+/account+/notifications.tsx
@@ -5,6 +5,9 @@ import { flash } from "@carbon/auth/session.server";
import { companyHasFeature } from "@carbon/ee/plan.server";
import { validationError, validator } from "@carbon/form";
import {
+ getNotificationTopicChannels,
+ isNotificationTopicEnabledByDefault,
+ type NotificationPreferenceChannel,
NotificationTopic,
USER_FACING_NOTIFICATION_TOPICS
} from "@carbon/notifications";
@@ -14,7 +17,8 @@ import {
CardDescription,
CardHeader,
CardTitle,
- Switch
+ Switch,
+ VStack
} from "@carbon/react";
import { msg } from "@lingui/core/macro";
import { Trans, useLingui } from "@lingui/react/macro";
@@ -33,6 +37,8 @@ export const handle: Handle = {
to: path.to.notificationSettings
};
+type Channel = NotificationPreferenceChannel;
+
export async function loader({ request }: LoaderFunctionArgs) {
const { client, userId, companyId } = await requirePermissions(request, {});
@@ -99,6 +105,7 @@ export default function AccountNotifications() {
// Labels live here rather than @carbon/notifications so Lingui extracts them.
const topicLabels: Record<NotificationTopic, string> = {
[NotificationTopic.Approval]: t`Approvals`,
+ [NotificationTopic.Changelog]: t`Changelog newsletter`,
[NotificationTopic.General]: t`General`,
[NotificationTopic.Inventory]: t`Inventory`,
[NotificationTopic.Items]: t`Items`,
@@ -112,8 +119,8 @@ export default function AccountNotifications() {
[NotificationTopic.Training]: t`Training`
};
- // Absence of a row = enabled; in-flight toggles win over loader data.
- const isEnabled = (topic: NotificationTopic, channel: "email" | "slack") => {
+ // No row means the topic's default; in-flight toggles win over loader data.
+ const isEnabled = (topic: NotificationTopic, channel: Channel) => {
let pending: boolean | undefined;
for (const fetcher of fetchers) {
if (
@@ -127,12 +134,12 @@ export default function AccountNotifications() {
const row = preferences.find(
(p) => p.topic === topic && p.channel === channel
);
- return row ? row.enabled : true;
+ return row ? row.enabled : isNotificationTopicEnabledByDefault(topic);
};
// A cell with a submission in flight is disabled: overlapping upserts for
// the same (topic, channel) would race and last-write-wins in the database.
- const isPending = (topic: NotificationTopic, channel: "email" | "slack") =>
+ const isPending = (topic: NotificationTopic, channel: Channel) =>
fetchers.some(
(fetcher) =>
fetcher.state !== "idle" &&
@@ -142,7 +149,7 @@ export default function AccountNotifications() {
const toggle = (
topic: NotificationTopic,
- channel: "email" | "slack",
+ channel: Channel,
next: boolean
) => {
submit(
@@ -152,85 +159,85 @@ export default function AccountNotifications() {
};
return (
- <Card>
- <CardHeader>
- <CardTitle>
- <Trans>Notifications</Trans>
- </CardTitle>
- <CardDescription>
- {slackActive ? (
- <Trans>
- In-app notifications are always delivered. Choose which topics
- also reach you by email or Slack.
- </Trans>
- ) : (
- <Trans>
- In-app notifications are always delivered. Choose which topics
- also reach you by email.
- </Trans>
+ <VStack spacing={4} className="pb-6">
+ <Card>
+ <CardHeader>
+ <CardTitle>
+ <Trans>Notifications</Trans>
+ </CardTitle>
+ <CardDescription>
+ {slackActive ? (
+ <Trans>
+ In-app notifications are always delivered. Choose which topics
+ also reach you by email or Slack.
+ </Trans>
+ ) : (
+ <Trans>
+ In-app notifications are always delivered. Choose which topics
+ also reach you by email.
+ </Trans>
+ )}
+ </CardDescription>
+ </CardHeader>
+ <CardContent>
+ {!emailPlanEnabled && (
+ <p className="text-sm text-muted-foreground mb-4">
+ <Trans>
+ Email notifications are not included in your company&apos;s
+ current plan; email preferences will apply if they are enabled.
+ </Trans>
+ </p>
)}
- </CardDescription>
- </CardHeader>
- <CardContent>
- {!emailPlanEnabled && (
- <p className="text-sm text-muted-foreground mb-4">
- <Trans>
- Email notifications are not included in your company&apos;s
- current plan; email preferences will apply if they are enabled.
- </Trans>
- </p>
- )}
- <table className="w-full">
- <thead>
- <tr className="border-b border-border">
- <th className="text-left text-sm font-medium py-2">
- <Trans>Topic</Trans>
- </th>
- <th className="text-center text-sm font-medium py-2 w-24">
- <Trans>Email</Trans>
- </th>
- {slackActive && (
+ <table className="w-full">
+ <thead>
+ <tr className="border-b border-border">
+ <th className="text-left text-sm font-medium py-2">
+ <Trans>Topic</Trans>
+ </th>
<th className="text-center text-sm font-medium py-2 w-24">
- <Trans>Slack</Trans>
+ <Trans>Email</Trans>
</th>
- )}
- </tr>
- </thead>
- <tbody>
- {USER_FACING_NOTIFICATION_TOPICS.map((topic) => (
- <tr key={topic} className="border-b border-border last:border-0">
- <td className="text-sm py-3">{topicLabels[topic]}</td>
- <td className="py-3 w-24">
- <div className="flex justify-center">
- <Switch
- checked={isEnabled(topic, "email")}
- disabled={isPending(topic, "email")}
- onCheckedChange={(checked) =>
- toggle(topic, "email", checked)
- }
- aria-label={`${topicLabels[topic]} ${t`email`}`}
- />
- </div>
- </td>
{slackActive && (
- <td className="py-3 w-24">
- <div className="flex justify-center">
- <Switch
- checked={isEnabled(topic, "slack")}
- disabled={isPending(topic, "slack")}
- onCheckedChange={(checked) =>
- toggle(topic, "slack", checked)
- }
- aria-label={`${topicLabels[topic]} ${t`Slack`}`}
- />
- </div>
- </td>
+ <th className="text-center text-sm font-medium py-2 w-24">
+ <Trans>Slack</Trans>
+ </th>
)}
</tr>
- ))}
- </tbody>
- </table>
- </CardContent>
- </Card>
+ </thead>
+ <tbody>
+ {USER_FACING_NOTIFICATION_TOPICS.map((topic) => {
+ const channels = getNotificationTopicChannels(topic);
+ const cell = (channel: Channel, label: string) => (
+ <td className="py-3 w-24">
+ {channels.includes(channel) && (
+ <div className="flex justify-center">
+ <Switch
+ checked={isEnabled(topic, channel)}
+ disabled={isPending(topic, channel)}
+ onCheckedChange={(checked) =>
+ toggle(topic, channel, checked)
+ }
+ aria-label={`${topicLabels[topic]} ${label}`}
+ />
+ </div>
+ )}
+ </td>
+ );
+ return (
+ <tr
+ key={topic}
+ className="border-b border-border last:border-0"
+ >
+ <td className="text-sm py-3">{topicLabels[topic]}</td>
+ {cell("email", t`email`)}
+ {slackActive && cell("slack", t`Slack`)}
+ </tr>
+ );
+ })}
+ </tbody>
+ </table>
+ </CardContent>
+ </Card>
+ </VStack>
);
}
diff --git a/apps/erp/app/utils/path.ts b/apps/erp/app/utils/path.ts
index d2a60b7c30..a8b945c4f9 100644
--- a/apps/erp/app/utils/path.ts
+++ b/apps/erp/app/utils/path.ts
@@ -449,6 +449,10 @@ export const path = {
calibrations: `${x}/quality/calibrations`,
cancelPurchasingRfq: (id: string) =>
generatePath(`${x}/purchasing-rfq/${id}/cancel`),
+ // The `?app=` hint lets the docs' Subscribe popover link to this instance.
+ changelog: withDocsHost("https://docs.carbon.ms/changelog"),
+ changelogEntry: (slug: string) =>
+ withDocsHost(`https://docs.carbon.ms/changelog/${slug}`),
changeNotice: (id: string) =>
generatePath(`${x}/items/change-notice/${id}`),
changeNoticeAction: (id: string) =>
diff --git a/docs/app/changelog/[slug]/page.tsx b/docs/app/changelog/[slug]/page.tsx
new file mode 100644
index 0000000000..c6f37131b4
--- /dev/null
+++ b/docs/app/changelog/[slug]/page.tsx
@@ -0,0 +1,100 @@
+import type { Metadata } from "next";
+import { notFound } from "next/navigation";
+import { ChangelogSection } from "@/components/changelog-section";
+import { ChangelogTag } from "@/components/changelog-timeline";
+import { getMDXComponents } from "@/components/mdx";
+import { formatChangelogDate } from "@/lib/changelog";
+import { pageSeo } from "@/lib/seo";
+import { changelogSource, getChangelogEntries } from "@/lib/source";
+
+type Params = { params: Promise<{ slug: string }> };
+
+/* A single entry reads as an article, not as one row of the feed: no timeline rail, a
+ * wider measure and a larger type scale than the summary it came from. */
+export default async function ChangelogEntryPage(props: Params) {
+ const { slug } = await props.params;
+ const page = changelogSource.getPage([slug]);
+ if (!page) notFound();
+
+ const MDX = page.data.body;
+
+ return (
+ <article className="mx-auto w-full max-w-[46rem] px-6 pt-10 pb-8 lg:px-8">
+ <a
+ href="/changelog"
+ className="inline-flex items-center gap-1.5 text-ed-14 font-book text-ink-faint no-underline transition-colors hover:text-ink-ui"
+ >
+ <span aria-hidden="true">←</span>
+ Changelog
+ </a>
+
+ <time
+ dateTime={page.data.date}
+ className="mt-10 block text-ed-14 font-medium tabular-nums text-ink-faint"
+ >
+ {formatChangelogDate(page.data.date)}
+ </time>
+
+ <h1 style={{ viewTransitionName: `title-${slug}` }} className="m-0 mt-3 font-display text-ed-40 font-semibold leading-[1.12] tracking-[-0.025em] text-ed-ink">
+ {page.data.title}
+ </h1>
+
+ {page.data.tags.length > 0 && (
+ <div className="mt-5 flex flex-wrap items-center gap-x-3 gap-y-2">
+ {page.data.tags.map((tag) => (
+ <ChangelogTag key={tag}>{tag}</ChangelogTag>
+ ))}
+ </div>
+ )}
+
+ {page.data.image && (
+ // eslint-disable-next-line @next/next/no-img-element
+ <img
+ src={page.data.image}
+ alt=""
+ width={1200}
+ height={675}
+ style={{ viewTransitionName: `hero-${slug}` }}
+ className="mt-9 aspect-video w-full rounded-xl bg-[#09090B] object-cover ring-1 ring-ed-ink/10 ring-inset"
+ />
+ )}
+
+ {/* `.guide-prose` (global.css) is the site's long-form reading rhythm: 17px at 1.75.
+ It was defined for the Guide and had no call sites; an entry page wants exactly
+ it, rather than a second size override competing with `.prose`. */}
+ <div className="prose guide-prose mt-10">
+ <MDX components={getMDXComponents({ Accordion: ChangelogSection })} />
+ </div>
+
+ <div className="mt-14 border-t border-ed-hairline pt-6">
+ <a
+ href="/changelog"
+ className="inline-flex items-center gap-1.5 text-ed-14 text-ed-brand-ink no-underline transition-colors hover:text-ed-ink"
+ >
+ <span aria-hidden="true">←</span>
+ Back to the changelog
+ </a>
+ </div>
+ </article>
+ );
+}
+
+export function generateStaticParams() {
+ return getChangelogEntries().map((entry) => ({
+ slug: entry.slugs[entry.slugs.length - 1],
+ }));
+}
+
+export async function generateMetadata(props: Params): Promise<Metadata> {
+ const { slug } = await props.params;
+ const page = changelogSource.getPage([slug]);
+ if (!page) notFound();
+
+ return pageSeo({
+ title: `${page.data.title} · Carbon Changelog`,
+ ogTitle: page.data.title,
+ description: page.data.description,
+ path: page.url,
+ eyebrow: "Changelog",
+ });
+}
diff --git a/docs/app/changelog/layout.tsx b/docs/app/changelog/layout.tsx
new file mode 100644
index 0000000000..fea0f7a75e
--- /dev/null
+++ b/docs/app/changelog/layout.tsx
@@ -0,0 +1,42 @@
+import type { ReactNode } from "react";
+import { MainHeader } from "@/components/main-header";
+import "../reference.css";
+
+/* Cross-document view transitions, inlined rather than put in a stylesheet.
+ *
+ * Next's `experimental.viewTransition` needs React 19's `unstable_ViewTransition`, and
+ * docs resolves React 18 despite declaring ^19.2.0 — so the client-router route is shut.
+ * This is the MPA route: the changelog's links are plain anchors, so navigation is
+ * cross-document and the browser drives the transition, morphing any element that shares
+ * a `view-transition-name` between the two pages.
+ *
+ * It has to be a literal <style>: Lightning CSS (Tailwind v4 / Turbopack) does not know
+ * the `@view-transition` at-rule and silently drops it from the compiled stylesheet.
+ * Verified by grepping the served CSS chunk. */
+const VIEW_TRANSITIONS = `
+@view-transition { navigation: auto; }
+@media (prefers-reduced-motion: no-preference) {
+ ::view-transition-group(*) {
+ animation-duration: 320ms;
+ animation-timing-function: cubic-bezier(0.22, 1, 0.36, 1);
+ }
+ ::view-transition-old(root),
+ ::view-transition-new(root) { animation-duration: 200ms; }
+}
+@media (prefers-reduced-motion: reduce) {
+ ::view-transition-group(*),
+ ::view-transition-old(root),
+ ::view-transition-new(root) { animation: none; }
+}
+`;
+
+export default function ChangelogLayout({ children }: { children: ReactNode }) {
+ return (
+ <div className="min-h-screen w-full bg-ed-paper">
+ {/* biome-ignore lint/security/noDangerouslySetInnerHtml: static stylesheet, no input */}
+ <style dangerouslySetInnerHTML={{ __html: VIEW_TRANSITIONS }} />
+ <MainHeader active="changelog" />
+ <main className="pt-16 pb-24">{children}</main>
+ </div>
+ );
+}
diff --git a/docs/app/changelog/page.tsx b/docs/app/changelog/page.tsx
new file mode 100644
index 0000000000..1c84ef2cba
--- /dev/null
+++ b/docs/app/changelog/page.tsx
@@ -0,0 +1,30 @@
+import type { Metadata } from "next";
+import { ChangelogFeed } from "@/components/changelog-feed";
+import { ChangelogHeader } from "@/components/changelog-header";
+import { pageSeo } from "@/lib/seo";
+
+const DESCRIPTION =
+ "New features, improvements, and fixes across the Carbon ERP and the shop floor.";
+
+export const metadata: Metadata = {
+ ...pageSeo({
+ title: "Changelog · Carbon",
+ ogTitle: "Changelog",
+ description: DESCRIPTION,
+ path: "/changelog",
+ eyebrow: "Changelog",
+ }),
+ alternates: {
+ canonical: "/changelog",
+ types: { "application/rss+xml": "/changelog/rss.xml" },
+ },
+};
+
+export default function ChangelogPage() {
+ return (
+ <>
+ <ChangelogHeader />
+ <ChangelogFeed />
+ </>
+ );
+}
diff --git a/docs/app/changelog/rss.xml/route.ts b/docs/app/changelog/rss.xml/route.ts
new file mode 100644
index 0000000000..f675740981
--- /dev/null
+++ b/docs/app/changelog/rss.xml/route.ts
@@ -0,0 +1,67 @@
+import { createElement } from "react";
+import { FEED_COMPONENTS } from "@/lib/changelog-feed-components";
+import { escapeXml, RSS_ITEM_LIMIT, rfc822Date } from "@/lib/changelog";
+import { SITE } from "@/lib/seo";
+import { getChangelogEntries } from "@/lib/source";
+
+// Built once; the feed only changes when an entry merges.
+export const dynamic = "force-static";
+
+type ChangelogEntry = ReturnType<typeof getChangelogEntries>[number];
+
+// `description` stays the short summary the dispatcher and the ERP panel read.
+async function entryHtml(entry: ChangelogEntry): Promise<string> {
+ // Dynamic import: Next rejects a static react-dom/server import in app/.
+ const { renderToStaticMarkup } = await import("react-dom/server");
+ const MDX = entry.data.body;
+ return renderToStaticMarkup(createElement(MDX, { components: FEED_COMPONENTS }));
+}
+
+function cdata(value: string): string {
+ return `<![CDATA[${value.replaceAll("]]>", "]]]]><![CDATA[>")}]]>`;
+}
+
+export async function GET() {
+ const entries = getChangelogEntries().slice(0, RSS_ITEM_LIMIT);
+ const bodies = await Promise.all(entries.map(entryHtml));
+ const items = entries
+ .map((entry, index) => {
+ const url = `${SITE.url}${entry.url}`;
+ return [
+ " <item>",
+ ` <title>${escapeXml(entry.data.title)}</title>`,
+ ` <link>${escapeXml(url)}</link>`,
+ ` <guid isPermaLink="true">${escapeXml(url)}</guid>`,
+ ` <pubDate>${rfc822Date(entry.data.date)}</pubDate>`,
+ entry.data.description
+ ? ` <description>${escapeXml(entry.data.description)}</description>`
+ : undefined,
+ ...entry.data.tags.map(
+ (tag) => ` <category>${escapeXml(tag)}</category>`
+ ),
+ // Last, so the dispatcher's first-match parser never reads a tag from the body.
+ ` <content:encoded>${cdata(bodies[index] ?? "")}</content:encoded>`,
+ " </item>",
+ ]
+ .filter(Boolean)
+ .join("\n");
+ })
+ .join("\n");
+
+ const xml = `<?xml version="1.0" encoding="UTF-8"?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/">
+ <channel>
+ <title>Carbon Changelog</title>
+ <link>${SITE.url}/changelog</link>
+ <atom:link href="${SITE.url}/changelog/rss.xml" rel="self" type="application/rss+xml" />
+ <description>What's new in Carbon, the manufacturing system. ERP for the office, MES for the floor.</description>
+ <language>en</language>
+${items}
+ </channel>
+</rss>
+`;
+
+ return new Response(xml, {
+ headers: { "Content-Type": "application/rss+xml; charset=utf-8" },
+ });
+}
diff --git a/docs/app/sitemap.ts b/docs/app/sitemap.ts
index 222c19e12e..cd1b931b55 100644
--- a/docs/app/sitemap.ts
+++ b/docs/app/sitemap.ts
@@ -1,7 +1,7 @@
import type { MetadataRoute } from "next";
import { allResourceParams } from "@/lib/api-data";
import { SITE } from "@/lib/seo";
-import { guideSource, source } from "@/lib/source";
+import { changelogSource, guideSource, source } from "@/lib/source";
import { allToolParams } from "@/lib/tools-data";
/** Every canonical, indexable URL on the docs site. `/` is intentionally omitted —
@@ -20,6 +20,12 @@ export default function sitemap(): MetadataRoute.Sitemap {
out.push({ url: abs(page.url), changeFrequency: "monthly", priority: 0.7 });
}
+ // Changelog (the feed page + one permalink per entry)
+ out.push({ url: abs("/changelog"), changeFrequency: "weekly", priority: 0.7 });
+ for (const page of changelogSource.getPages()) {
+ out.push({ url: abs(page.url), changeFrequency: "yearly", priority: 0.5 });
+ }
+
// Carbon API (the headline surface — service layer, reached over MCP today)
out.push({ url: abs("/api"), changeFrequency: "monthly", priority: 0.7 });
out.push({ url: abs("/api/mcp"), changeFrequency: "monthly", priority: 0.5 });
diff --git a/docs/components/changelog-active-entry.tsx b/docs/components/changelog-active-entry.tsx
new file mode 100644
index 0000000000..efb505bbc4
--- /dev/null
+++ b/docs/components/changelog-active-entry.tsx
@@ -0,0 +1,37 @@
+"use client";
+
+import { useEffect } from "react";
+
+/* Lights the rail entry you are currently reading.
+ *
+ * Deliberately additive: every entry is already in the SSR HTML and fully visible, and
+ * this only toggles an attribute on them. The earlier treatment faded entries IN as they
+ * scrolled into view, which gated content behind the scroll and read as lag. */
+export function ChangelogActiveEntry() {
+ useEffect(() => {
+ const articles = Array.from(document.querySelectorAll<HTMLElement>("article[id]"));
+ if (articles.length === 0) return;
+
+ const setActive = (target: Element) => {
+ for (const article of articles) {
+ article.toggleAttribute("data-active", article === target);
+ }
+ };
+
+ // A thin band across the upper third: whichever entry crosses it is the one being
+ // read. Between entries nothing intersects, so the last one stays lit.
+ const observer = new IntersectionObserver(
+ (entries) => {
+ for (const entry of entries) {
+ if (entry.isIntersecting) setActive(entry.target);
+ }
+ },
+ { rootMargin: "-22% 0px -70% 0px" }
+ );
+
+ for (const article of articles) observer.observe(article);
+ return () => observer.disconnect();
+ }, []);
+
+ return null;
+}
diff --git a/docs/components/changelog-feed.tsx b/docs/components/changelog-feed.tsx
new file mode 100644
index 0000000000..661f683b79
--- /dev/null
+++ b/docs/components/changelog-feed.tsx
@@ -0,0 +1,70 @@
+import { ChangelogActiveEntry } from "@/components/changelog-active-entry";
+import { ChangelogRow, ChangelogTag } from "@/components/changelog-timeline";
+import { getChangelogEntries } from "@/lib/source";
+
+const FEED_TAG_LIMIT = 3;
+
+/* One continuous timeline, with no pager and no scroll reveal. Entries are summaries, so the
+ * whole archive is a short scroll, and every one ships visible in the SSR HTML: a feed
+ * that fades itself in as you scroll reads as lag, not polish. */
+export function ChangelogFeed() {
+ const entries = getChangelogEntries();
+
+ return (
+ <>
+ <h1 className="sr-only">Changelog</h1>
+ <ChangelogActiveEntry />
+
+ {entries.map((entry) => {
+ const slug = entry.slugs[entry.slugs.length - 1];
+ return (
+ <article key={entry.url} id={slug} className="group scroll-mt-24">
+ <ChangelogRow date={entry.data.date} href={entry.url}>
+ {entry.data.image && (
+ // eslint-disable-next-line @next/next/no-img-element
+ <img
+ src={entry.data.image}
+ alt=""
+ width={1200}
+ height={675}
+ style={{ viewTransitionName: `hero-${slug}` }}
+ className="mb-7 aspect-video w-full rounded-xl bg-[#09090B] object-cover ring-1 ring-ed-ink/10 ring-inset"
+ />
+ )}
+ <h2 style={{ viewTransitionName: `title-${slug}` }} className="m-0 font-display text-ed-24 font-semibold leading-[1.3] tracking-[-0.015em] text-ed-ink">
+ {/* A plain anchor, not next/link: a cross-document navigation is what lets
+ the browser run the view transition. Stretched over the whole row, so
+ anywhere in the entry is clickable. */}
+ <a
+ href={entry.url}
+ className="no-underline after:absolute after:inset-0"
+ >
+ {entry.data.title}
+ </a>
+ </h2>
+ {entry.data.description && (
+ <p className="m-0 mt-3 text-ed-16 leading-relaxed text-ink-body">
+ {entry.data.description}
+ </p>
+ )}
+ <div className="mt-6 flex flex-wrap items-center gap-x-3 gap-y-2">
+ {entry.data.tags.slice(0, FEED_TAG_LIMIT).map((tag) => (
+ <ChangelogTag key={tag}>{tag}</ChangelogTag>
+ ))}
+ <span className="inline-flex items-center gap-1.5 text-ed-14 font-book text-ed-brand-ink">
+ Read the full entry
+ <span
+ aria-hidden="true"
+ className="transition-transform duration-200 ease-[cubic-bezier(0.22,1,0.36,1)] group-hover:translate-x-0.5"
+ >
+ →
+ </span>
+ </span>
+ </div>
+ </ChangelogRow>
+ </article>
+ );
+ })}
+ </>
+ );
+}
diff --git a/docs/components/changelog-header.tsx b/docs/components/changelog-header.tsx
new file mode 100644
index 0000000000..b0430e70f9
--- /dev/null
+++ b/docs/components/changelog-header.tsx
@@ -0,0 +1,47 @@
+import Link from "next/link";
+import { ChangelogSubscribe } from "@/components/changelog-subscribe";
+
+function RssIcon() {
+ return (
+ <svg viewBox="0 0 16 16" fill="currentColor" aria-hidden="true" className="size-4">
+ <path
+ fillRule="evenodd"
+ clipRule="evenodd"
+ d="M2.5 3a.5.5 0 0 1 .5-.5h.5c5.523 0 10 4.477 10 10v.5a.5.5 0 0 1-.5.5h-.5a.5.5 0 0 1-.5-.5v-.5A8.5 8.5 0 0 0 3.5 4H3a.5.5 0 0 1-.5-.5V3Zm0 4.5A.5.5 0 0 1 3 7h.5A5.5 5.5 0 0 1 9 12.5v.5a.5.5 0 0 1-.5.5H8a.5.5 0 0 1-.5-.5v-.5a4 4 0 0 0-4-4H3a.5.5 0 0 1-.5-.5v-.5Zm0 5a1 1 0 1 1 2 0 1 1 0 0 1-2 0Z"
+ />
+ </svg>
+ );
+}
+
+/* Page header on Linear's pattern: the title left-aligned at the top, a row beneath it
+ * carrying the blurb and the actions, then a full-width rule. The header spans a wider
+ * container than the entry column, which stays centred below it. */
+export function ChangelogHeader() {
+ return (
+ <header className="mx-auto w-full max-w-[80rem] px-6 pt-14 lg:px-8 lg:pt-20">
+ {/* Actions ride the title row at every width: one Subscribe instance rather than a
+ mobile/desktop pair, which would mount two popovers. */}
+ <div className="flex flex-wrap items-center justify-between gap-x-4 gap-y-5">
+ <h1 className="m-0 text-ed-32 font-light leading-[1.05] tracking-[-0.03em] text-ed-ink sm:text-ed-40">
+ Changelog
+ </h1>
+ <div className="flex shrink-0 items-center gap-2">
+ {/* Direct link to the raw feed, next to the subscribe options. */}
+ <Link
+ href="/changelog/rss.xml"
+ aria-label="RSS feed"
+ title="RSS feed"
+ className="inline-flex h-10 w-10 items-center justify-center rounded-lg border border-ed-hairline bg-[#F5F5F2] text-ink-faint no-underline transition-colors hover:border-ed-warm-400 hover:text-ink-ui"
+ >
+ <RssIcon />
+ </Link>
+ <ChangelogSubscribe />
+ </div>
+ </div>
+ <p className="m-0 mt-5 max-w-[34rem] pb-6 text-ed-16 leading-relaxed text-ink-body">
+ New features, improvements, and fixes across the ERP and the shop floor.
+ </p>
+ <div className="h-px w-full bg-ed-hairline" />
+ </header>
+ );
+}
diff --git a/docs/components/changelog-section.tsx b/docs/components/changelog-section.tsx
new file mode 100644
index 0000000000..dd2ec7643b
--- /dev/null
+++ b/docs/components/changelog-section.tsx
@@ -0,0 +1,46 @@
+import type { ReactNode } from "react";
+
+function SparkleIcon() {
+ return (
+ <svg viewBox="0 0 24 24" fill="currentColor" className="size-4 shrink-0" aria-hidden="true">
+ <path d="M11 3 12.6 8.4 18 10l-5.4 1.6L11 17l-1.6-5.4L4 10l5.4-1.6z" />
+ <path d="M18.5 14.5 19.3 17l2.5.8-2.5.8-.8 2.5-.8-2.5-2.5-.8 2.5-.8z" opacity="0.55" />
+ </svg>
+ );
+}
+
+function WrenchIcon() {
+ return (
+ <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" className="size-4 shrink-0" aria-hidden="true">
+ <path d="M14.7 6.3a4 4 0 0 0 5 5l-8.4 8.4a2.4 2.4 0 0 1-3.4-3.4z" />
+ <path d="m17.5 3.5 3 3" />
+ </svg>
+ );
+}
+
+// "Fixes" gets the wrench, anything else the sparkle: the two titles the entries use.
+function iconFor(title: string) {
+ return /fix/i.test(title) ? <WrenchIcon /> : <SparkleIcon />;
+}
+
+/* Replaces <Accordion> inside a changelog entry. A release note's Improvements and Fixes
+ * are the substance of the entry, not an aside to be opened, so they render as a plain
+ * titled section. The RSS route degrades the same component to an <h3> plus its list, so
+ * the page, the feed and the newsletter all show the same thing. */
+export function ChangelogSection({
+ title,
+ children,
+}: {
+ title: string;
+ children: ReactNode;
+}) {
+ return (
+ <section className="mt-10 border-t border-ed-hairline pt-6 first:mt-0">
+ <h3 className="m-0 flex items-center gap-2 text-ed-15 font-demi text-ed-brand-ink">
+ {iconFor(title)}
+ <span className="text-ink-ui">{title}</span>
+ </h3>
+ <div className="[&>ul]:mt-3 [&>ul]:mb-0">{children}</div>
+ </section>
+ );
+}
diff --git a/docs/components/changelog-subscribe.tsx b/docs/components/changelog-subscribe.tsx
new file mode 100644
index 0000000000..5a4f52b2e6
--- /dev/null
+++ b/docs/components/changelog-subscribe.tsx
@@ -0,0 +1,130 @@
+"use client";
+
+// Email is managed from the reader's Carbon account, so there is no form here.
+
+import { useEffect, useRef, useState } from "react";
+import { DEFAULT_APP_ORIGIN } from "./api/config-constants";
+import { ApiConfigProvider, appOrigin, useApiConfig } from "./api/config-context";
+
+const FEED_URL = "https://docs.carbon.ms/changelog/rss.xml";
+const SLACK_COMMAND = `/feed subscribe ${FEED_URL}`;
+const NEWSLETTER_SETTINGS_PATH = "/x/account/notifications";
+
+// The reader's own instance when known (API-page region or the ERP's `?app=`
+// hint), else Carbon Cloud US.
+function useNewsletterSettingsUrl(): string {
+ const { base, appBase } = useApiConfig();
+ return `${appOrigin(base, appBase) ?? DEFAULT_APP_ORIGIN}${NEWSLETTER_SETTINGS_PATH}`;
+}
+
+function CopyRow({ label, value }: { label: string; value: string }) {
+ const [copied, setCopied] = useState(false);
+ return (
+ <div>
+ <div className="mb-1.5 text-[12px] font-demi uppercase tracking-[0.06em] text-ink-faint">
+ {label}
+ </div>
+ <button
+ type="button"
+ onClick={() => {
+ navigator.clipboard.writeText(value).then(() => {
+ setCopied(true);
+ setTimeout(() => setCopied(false), 1600);
+ });
+ }}
+ title="Copy to clipboard"
+ className="flex w-full items-center justify-between gap-2 rounded-lg border border-ed-hairline bg-[#F5F5F2] px-3 py-2 text-left font-mono text-[12px] text-ink-ui transition-colors hover:border-[#D8D8D3]"
+ >
+ <span className="truncate">{value}</span>
+ <span className="shrink-0 text-[11px] font-sans text-ink-faint">
+ {copied ? "Copied" : "Copy"}
+ </span>
+ </button>
+ </div>
+ );
+}
+
+// The changelog sits outside the API layout, so it mounts its own provider.
+export function ChangelogSubscribe() {
+ return (
+ <ApiConfigProvider>
+ <SubscribePopover />
+ </ApiConfigProvider>
+ );
+}
+
+function SubscribePopover() {
+ const newsletterSettingsUrl = useNewsletterSettingsUrl();
+ const [open, setOpen] = useState(false);
+ const rootRef = useRef<HTMLDivElement>(null);
+
+ useEffect(() => {
+ if (!open) return;
+ const onDown = (e: MouseEvent) => {
+ if (!rootRef.current?.contains(e.target as Node)) setOpen(false);
+ };
+ const onKey = (e: KeyboardEvent) => {
+ if (e.key === "Escape") setOpen(false);
+ };
+ document.addEventListener("mousedown", onDown);
+ document.addEventListener("keydown", onKey);
+ return () => {
+ document.removeEventListener("mousedown", onDown);
+ document.removeEventListener("keydown", onKey);
+ };
+ }, [open]);
+
+ return (
+ <div ref={rootRef} className="relative">
+ <button
+ type="button"
+ onClick={() => setOpen((v) => !v)}
+ aria-expanded={open}
+ className="group relative inline-flex h-10 items-center justify-center gap-2 rounded-lg px-4 transition-transform duration-150 ease-[cubic-bezier(0.22,1,0.36,1)] active:scale-[0.97]"
+ >
+ <span aria-hidden="true" className="pointer-events-none absolute inset-0 rounded-lg cta-btn-dark" />
+ <span
+ aria-hidden="true"
+ className="pointer-events-none absolute inset-0 rounded-lg btn-dark-hover opacity-0 transition-opacity duration-200 ease-out group-hover:opacity-100"
+ />
+ <span className="text-on-dark relative z-10 text-ed-14 font-book tracking-[0.15px]">
+ Subscribe
+ </span>
+ <span
+ aria-hidden="true"
+ className="text-on-dark relative z-10 transition-transform duration-200 ease-[cubic-bezier(0.22,1,0.36,1)] group-hover:translate-x-0.5"
+ >
+ →
+ </span>
+ </button>
+
+ {open && (
+ <div className="absolute right-0 top-full z-30 mt-2 w-[21rem] rounded-xl border border-ed-hairline bg-[#FBFBF9] p-4 shadow-[0_12px_32px_rgba(38,35,35,0.10)]">
+ <div className="mb-4">
+ <div className="mb-1.5 text-[12px] font-demi uppercase tracking-[0.06em] text-ink-faint">
+ Email
+ </div>
+ <a
+ href={newsletterSettingsUrl}
+ className="flex w-full items-center justify-between gap-2 rounded-lg bg-[#1E84B0] px-3.5 py-2 text-ed-14 font-book text-white no-underline transition-opacity hover:opacity-90"
+ >
+ <span>Turn on the email digest</span>
+ <span aria-hidden="true">→</span>
+ </a>
+ <p className="m-0 mt-1.5 text-[12px] leading-normal text-ink-faint">
+ Opens Account → Notifications in your Carbon instance.
+ </p>
+ </div>
+
+ <div className="flex flex-col gap-4">
+ <CopyRow label="RSS" value={FEED_URL} />
+ <CopyRow label="Slack" value={SLACK_COMMAND} />
+ </div>
+ <p className="m-0 mt-3 text-[12px] leading-normal text-ink-faint">
+ Paste into any Slack channel to post new entries there.
+ </p>
+ </div>
+ )}
+ </div>
+ );
+}
diff --git a/docs/components/changelog-timeline.tsx b/docs/components/changelog-timeline.tsx
new file mode 100644
index 0000000000..9a7ea148aa
--- /dev/null
+++ b/docs/components/changelog-timeline.tsx
@@ -0,0 +1,67 @@
+import type { ReactNode } from "react";
+import { formatChangelogDate } from "@/lib/changelog";
+
+/* Centred single column with the date hanging in the left margin, on the pattern Linear
+ * and Cloudflare use: the ENTRY column is centred on the page and the date sits outside
+ * it, rather than the pair being centred together, which would push the reading column
+ * off-centre.
+ *
+ * The rule is a left border on the entry cell, and the vertical rhythm is PADDING inside
+ * that cell rather than margin between articles; that is what keeps the line continuous
+ * down the page instead of breaking at every gap.
+ *
+ * The date only hangs out from `xl`, where there is margin to hang it in. Below that it
+ * runs inline above the entry. */
+export function ChangelogRow({
+ date,
+ href,
+ children,
+}: {
+ date: string;
+ href: string;
+ children: ReactNode;
+}) {
+ const label = formatChangelogDate(date);
+ const time = (className: string) => (
+ <time
+ dateTime={date}
+ className={`whitespace-nowrap text-ed-13 font-medium leading-5 tabular-nums text-ink-faint transition-colors duration-200 group-data-[active]:text-ed-ink ${className}`}
+ >
+ {label}
+ </time>
+ );
+
+ return (
+ <div className="mx-auto w-full max-w-[42rem] px-6">
+ <div className="relative py-10 md:border-l md:border-dashed md:border-ed-warm-500 md:py-14 md:pl-12">
+ <a
+ href={href}
+ className="absolute top-14 right-full mr-10 hidden w-40 text-right no-underline xl:block"
+ >
+ {time("")}
+ </a>
+
+ {/* The node, centred on the rule. */}
+ <span className="absolute top-[3.6rem] -left-[7px] hidden size-3.5 md:block">
+ <span className="absolute inset-0 rounded-full border-2 border-ed-warm-500 bg-ed-paper transition-[background-color,border-color] duration-200 group-data-[active]:border-ed-brand-ink group-data-[active]:bg-ed-brand-ink" />
+ <span className="absolute inset-0 scale-50 rounded-full bg-ed-brand-ink/20 opacity-0 transition-[transform,opacity] duration-300 ease-[cubic-bezier(0.22,1,0.36,1)] group-data-[active]:scale-[2.2] group-data-[active]:opacity-100" />
+ </span>
+
+ <a href={href} className="mb-5 flex w-fit no-underline xl:hidden">
+ {time("")}
+ </a>
+
+ {children}
+ </div>
+ </div>
+ );
+}
+
+/** A tag chip: quiet metadata, never competing with the title or the action. */
+export function ChangelogTag({ children }: { children: ReactNode }) {
+ return (
+ <span className="inline-flex items-center rounded-md bg-ed-warm-150 px-2 py-0.5 font-mono text-ed-12 leading-5 text-ed-ink/55">
+ {children}
+ </span>
+ );
+}
diff --git a/docs/components/editorial/accordion.tsx b/docs/components/editorial/accordion.tsx
new file mode 100644
index 0000000000..cd9de7f37d
--- /dev/null
+++ b/docs/components/editorial/accordion.tsx
@@ -0,0 +1,35 @@
+import type { ReactNode } from "react";
+
+// Native <details>: works without JS and stays open-able from find-in-page.
+export function Accordion({
+ title,
+ children,
+}: {
+ title: string;
+ children: ReactNode;
+}) {
+ return (
+ <details className="group my-3 rounded-[10px] border border-ed-hairline bg-[#F5F5F2]/70">
+ <summary className="flex cursor-pointer select-none list-none items-center justify-between gap-3 px-4 py-3 text-ed-15 font-demi text-ink-ui [&::-webkit-details-marker]:hidden">
+ {title}
+ <svg
+ width="14"
+ height="14"
+ viewBox="0 0 24 24"
+ fill="none"
+ stroke="currentColor"
+ strokeWidth="2"
+ strokeLinecap="round"
+ strokeLinejoin="round"
+ aria-hidden="true"
+ className="shrink-0 text-ink-faint transition-transform duration-200 group-open:rotate-180"
+ >
+ <path d="m6 9 6 6 6-6" />
+ </svg>
+ </summary>
+ <div className="border-t border-ed-hairline px-4 pb-1 [&>ul]:my-3">
+ {children}
+ </div>
+ </details>
+ );
+}
diff --git a/docs/components/main-header.tsx b/docs/components/main-header.tsx
index bc6f67c144..4548e1ffe2 100644
--- a/docs/components/main-header.tsx
+++ b/docs/components/main-header.tsx
@@ -8,6 +8,7 @@ const NAV = [
{ key: "reference", label: "Reference", href: "/docs" },
{ key: "guides", label: "Guides", href: "/guides/order" },
{ key: "api", label: "API", href: "/api" },
+ { key: "changelog", label: "Changelog", href: "/changelog" },
] as const;
type Active = (typeof NAV)[number]["key"];
diff --git a/docs/components/mdx.tsx b/docs/components/mdx.tsx
index 34118a989d..051a104475 100644
--- a/docs/components/mdx.tsx
+++ b/docs/components/mdx.tsx
@@ -5,6 +5,7 @@ import defaultMdxComponents from "fumadocs-ui/mdx";
import type { MDXComponents } from "mdx/types";
import type { ComponentProps } from "react";
import { Checklist, Check } from "@/components/checklist";
+import { Accordion } from "@/components/editorial/accordion";
import { Field, FieldTable } from "@/components/editorial/field-table";
import { Glossary } from "@/components/editorial/glossary";
// Figure/Screenshot + the shared Zoomable island so the Reference gets the same
@@ -51,6 +52,7 @@ export function getMDXComponents(components?: MDXComponents) {
<img {...props} alt={alt ?? ""} className="block w-full rounded-xl border border-ed-hairline" />
</Zoomable>
),
+ Accordion,
Card,
Cards,
Callout,
diff --git a/docs/components/mobile-nav.tsx b/docs/components/mobile-nav.tsx
index 81565d2dee..89f2462d18 100644
--- a/docs/components/mobile-nav.tsx
+++ b/docs/components/mobile-nav.tsx
@@ -28,6 +28,7 @@ const NAV = [
{ key: "reference", label: "Reference", href: "/docs" },
{ key: "guides", label: "Guides", href: "/guides/order" },
{ key: "api", label: "API", href: "/api" },
+ { key: "changelog", label: "Changelog", href: "/changelog" },
] as const;
type Active = (typeof NAV)[number]["key"];
diff --git a/docs/content/changelog/2026-03-31-time-clock-and-quality-dashboard.mdx b/docs/content/changelog/2026-03-31-time-clock-and-quality-dashboard.mdx
new file mode 100644
index 0000000000..c83a07d656
--- /dev/null
+++ b/docs/content/changelog/2026-03-31-time-clock-and-quality-dashboard.mdx
@@ -0,0 +1,48 @@
+---
+title: "Employee time clock and the Quality dashboard"
+description: "An employee time clock with breaks and overtime, a new Quality dashboard, and non-taxable add-ons on sales documents."
+date: "2026-03-31"
+tags: ["people", "quality", "sales"]
+image: "/changelog/2026-03-31-time-clock-and-quality-dashboard.svg"
+---
+
+Time tracking and quality both got a home screen.
+
+## Employee time clock
+
+Employees can now clock in and out in Carbon, with breaks, flags and overtime tracked on the time card. See [people](/docs/reference/people).
+
+## The Quality dashboard
+
+The [Quality](/docs/reference/quality) dashboard brings issues, inspections and open actions onto one screen.
+
+## Non-taxable add-ons
+
+[Quotes](/docs/reference/quotes), [sales orders](/docs/reference/sales-orders) and [sales invoices](/docs/reference/invoices) accept non-taxable add-ons.
+
+<Accordion title="Improvements">
+
+- Converting a quote to a sales order generates and attaches the sales order PDF.
+- The sales order summary shows invoiced and paid amounts.
+- The item master gained an exploded bill of materials view.
+- BOM exports include cost estimates, including the cost of subassemblies.
+- Demand forecast is shown on the inventory table, and planning tables sort by quantity to order.
+- Tracked entities can be updated and deleted, and you're warned if you forget to issue a tracked part.
+- Shipment lines accept a readable id.
+- Inventory adjustments carry a comment.
+- Drawers have a new floating look.
+- Academy: new Issues and Gauges & Calibrations videos.
+
+</Accordion>
+
+<Accordion title="Fixes">
+
+- Invoicing partial shipments no longer miscounts.
+- Quote lines take the operation minimum cost from the method operation.
+- Notes, assignee, and custom fields respect record locks.
+- The payment dropdown is disabled by invoice status and permissions.
+- Deactivating and reactivating a user no longer poisons the permissions cache.
+- Inventory quantities no longer show duplicate rows across companies.
+- The issues view's containment status column renders correctly.
+
+</Accordion>
diff --git a/docs/content/changelog/2026-04-14-passkeys.mdx b/docs/content/changelog/2026-04-14-passkeys.mdx
new file mode 100644
index 0000000000..4fa928b88a
--- /dev/null
+++ b/docs/content/changelog/2026-04-14-passkeys.mdx
@@ -0,0 +1,50 @@
+---
+title: "Carbon MCP server, passkeys, and Console mode"
+description: "Connect AI clients over MCP, sign in with a passkey, Console mode on the shop floor, and five new languages."
+date: "2026-04-14"
+tags: ["auth", "mcp", "settings"]
+image: "/changelog/2026-04-14-passkeys.svg"
+---
+
+AI clients can now work with your Carbon data, and nobody needs a password to sign in.
+
+## The Carbon MCP server
+
+The [MCP server](/api/mcp) lets Claude, Cursor and other AI clients work with your data through Carbon's tools.
+
+## Passkeys
+
+Passkeys arrive for passwordless sign-in. Register one from your [account](/docs/reference/account), sign in with Face ID, Touch ID or a security key, and rename or remove passkeys you no longer use.
+
+## Console mode
+
+Console mode runs a shared shop-floor device without a personal session. See [MES](/docs/reference/mes).
+
+## Five new languages
+
+Carbon is now available in Hindi, French, Polish, Portuguese and Russian, and the login page is translated too.
+
+<Accordion title="Improvements">
+
+- Method types are now named for what they do: Pull from Inventory, Purchase to Order, and Make to Order (previously Pick, Buy, Make).
+- CSV import tools.
+- A Recalculate unit cost button on the item master.
+- Purchased lead time is updated from a weighted yearly average.
+- API key expiration dates are validated more strictly.
+- Active time cards count toward duration calculations.
+- Risk updates carry more detail.
+
+</Accordion>
+
+<Accordion title="Fixes">
+
+- Markup is calculated correctly on purchased quoted parts.
+- External notes show on the digital quote.
+- Purchasing RFQ property updates save correctly.
+- Audit logs that went missing are recorded again.
+- Line-item document errors are handled instead of failing the page.
+- Onshape sync tolerates a missing item.
+- Faster dialogs and forms.
+- A cross-site scripting vulnerability was closed.
+
+</Accordion>
diff --git a/docs/content/changelog/2026-04-28-inventory-storage.mdx b/docs/content/changelog/2026-04-28-inventory-storage.mdx
new file mode 100644
index 0000000000..3a91af2c6f
--- /dev/null
+++ b/docs/content/changelog/2026-04-28-inventory-storage.mdx
@@ -0,0 +1,50 @@
+---
+title: "Inbound inspections, pricing rules, and storage units"
+description: "Inspect what you receive, price by rule, and model your warehouse as storage units and types."
+date: "2026-04-28"
+tags: ["quality", "sales", "inventory"]
+image: "/changelog/2026-04-28-inventory-storage.svg"
+---
+
+Your warehouse probably isn't a flat list of bins. Inventory storage now models it the way it is.
+
+## Storage units and storage types
+
+[Inventory](/docs/reference/inventory) storage has been rebuilt around storage units and storage types, so a location's bins, shelves and racks are modeled the way your warehouse works.
+
+## Inbound inspections
+
+Inbound [inspections](/docs/reference/inspections) put [received](/docs/reference/receipts) goods through an inspection before they become available.
+
+## Pricing rules
+
+[Pricing rules](/docs/reference/pricing) set prices by rule instead of by hand.
+
+<Accordion title="Improvements">
+
+- Negative adjustments for batch- and serial-tracked parts.
+- Duplicate a pricing list.
+- Due dates can be edited inline on schedule job cards, and empty work centers can be hidden.
+- Receipts can be created when line items have no price.
+- Purchase order delivery dates are editable regardless of status.
+- Purchase invoice status "Submitted" is now "Open".
+- The BOM combobox reveals its dropdown on hover, sizes to its content, and shows tooltips for truncated names.
+- The language dropdown lists every available locale.
+- Audit configuration can name the fields recorded on create.
+- MCP: search and call tools.
+
+</Accordion>
+
+<Accordion title="Fixes">
+
+- Active make methods can no longer be overwritten.
+- Backflushing serial parts includes their children.
+- Serial and batch tracked entities are restored on job creation.
+- Customer part ids are deduplicated on quotes and RFQs.
+- Active quotes no longer auto-close.
+- Jobs auto-complete correctly, and method type reads Make to Order rather than Make.
+- Purchase invoice line prices update on the right trigger.
+- Sign-in failures show consistent messages.
+- Paperless Parts no longer overwrites data.
+
+</Accordion>
diff --git a/docs/content/changelog/2026-05-12-item-constraint-rules.mdx b/docs/content/changelog/2026-05-12-item-constraint-rules.mdx
new file mode 100644
index 0000000000..663e946f06
--- /dev/null
+++ b/docs/content/changelog/2026-05-12-item-constraint-rules.mdx
@@ -0,0 +1,51 @@
+---
+title: "Multi-entity accounting, storage rules, and shelf life"
+description: "Run several legal entities in one company group, guard inventory transactions with storage rules, and track shelf life."
+date: "2026-05-12"
+tags: ["accounting", "inventory", "items"]
+image: "/changelog/2026-05-12-item-constraint-rules.svg"
+---
+
+One company group, several sets of books, and rules that stop a bad inventory transaction before it posts.
+
+## Multi-entity accounting
+
+Multi-entity accounting lets a company group run several legal entities with their own books, with [intercompany](/docs/reference/intercompany) trade between them.
+
+## Storage rules
+
+A [storage rule](/docs/reference/storage-rules) runs when an inventory transaction posts. It checks the line against a condition you define and either blocks the transaction, or warns and lets the user continue. Rules attach to [items](/docs/reference/items) or [work centers](/docs/reference/work-centers).
+
+## Shelf life
+
+[Shelf life](/docs/reference/shelf-life) is tracked on items and batches.
+
+## Traceability explorer, rebuilt
+
+The [traceability explorer](/docs/reference/traceability) has been rebuilt for large genealogies, and dates across the app now follow your locale.
+
+<Accordion title="Improvements">
+
+- Incoterms and EORI numbers.
+- An Accounting settings page; supplier approval moved out of company settings.
+- Job materials can be backflushed.
+- Plan upgrade banners show where a feature needs the Business plan.
+- The configurator can eliminate a part or process with an empty value.
+- Language selection moved to the avatar menu.
+- Stripe invoice notifications, including invoice sent.
+
+</Accordion>
+
+<Accordion title="Fixes">
+
+- Files can be uploaded and dates changed on documents in any status.
+- Supplier approval no longer fails.
+- RFQ-to-quote flow fixes.
+- Shipment lines validate batch input, check expiry, and no longer go stale.
+- Receipts, shipments, and stock transfers only list Draft items when filtering by tracking status.
+- Shelf-life inventory adjustments follow the right path.
+- Traceability paths resolve correctly.
+- Risks for a source entity are matched with AND logic.
+- Job completion handles a split-duplicated tracked entity and surfaces the real error.
+
+</Accordion>
diff --git a/docs/content/changelog/2026-05-26-shelf-life-history.mdx b/docs/content/changelog/2026-05-26-shelf-life-history.mdx
new file mode 100644
index 0000000000..6c1ea41136
--- /dev/null
+++ b/docs/content/changelog/2026-05-26-shelf-life-history.mdx
@@ -0,0 +1,49 @@
+---
+title: "Fixed assets, redesigned PDFs, and menu customization"
+description: "Track fixed assets, every PDF redesigned, reorder your sidebar, and keep a shelf-life history."
+date: "2026-05-26"
+tags: ["accounting", "documents", "inventory"]
+image: "/changelog/2026-05-26-shelf-life-history.svg"
+---
+
+Fixed assets arrive, and every PDF in Carbon has been redrawn.
+
+## Fixed assets
+
+[Fixed assets](/docs/reference/fixed-assets) arrive in accounting.
+
+## Redesigned PDFs
+
+Every [document](/docs/reference/documents) has been redesigned, with further improvements to the purchasing documents.
+
+## A customizable sidebar
+
+The sidebar can be customized, so you can reorder modules and hide the ones you don't use.
+
+<Accordion title="Improvements">
+
+- Shelf-life history and an inventory history menu.
+- Reorder line items on documents.
+- Filter the inventory table by storage unit.
+- Expand or collapse every level of a BOM explorer at once.
+- Traceability search disambiguates readable ids with job and tracking context.
+- Hide empty work centers on the schedule.
+- Audit logs snapshot related records.
+- New fields on CSV imports.
+- Email notifications are a plan feature, shown as such in settings.
+- Onboarding's plan selection and model viewer were refined.
+- Academy: Historical Costs, Purchase Invoices, Purchasing Planning, and Supplier Pricing videos.
+
+</Accordion>
+
+<Accordion title="Fixes">
+
+- Make-to-order jobs issue to inventory and create cost of goods sold on shipment.
+- Unlinking a job from a sales order asks for confirmation.
+- Released job material operations validate correctly.
+- The BOM explorer popover no longer disappears too quickly.
+- Realtime reconnects when the tab becomes visible again.
+- Notification links validate job parameters.
+- Sidebar scrollbars fixed.
+
+</Accordion>
diff --git a/docs/content/changelog/2026-06-09-rework-and-ballooning.mdx b/docs/content/changelog/2026-06-09-rework-and-ballooning.mdx
new file mode 100644
index 0000000000..7001d5c03e
--- /dev/null
+++ b/docs/content/changelog/2026-06-09-rework-and-ballooning.mdx
@@ -0,0 +1,53 @@
+---
+title: "Rework, Purchasing Planning 2.0, and ballooning diagrams"
+description: "Send serial and batch parts through rework, a rebuilt purchasing planning, ballooned inspection diagrams, and MCP 2.0 with OAuth."
+date: "2026-06-09"
+tags: ["quality", "purchasing", "mcp"]
+image: "/changelog/2026-06-09-rework-and-ballooning.svg"
+---
+
+Parts that fail inspection no longer fall off the system.
+
+## Rework
+
+[Serial- and batch-tracked](/docs/reference/traceability) parts can be sent through rework.
+
+## Purchasing Planning 2.0
+
+Purchasing Planning 2.0 rebuilds the buying workspace. See [planning](/docs/reference/planning).
+
+## Ballooning diagrams, and quality issues from the floor
+
+[Quality](/docs/reference/quality) gained ballooning diagrams for [inspections](/docs/reference/inspections), and an operator can raise a quality [issue](/docs/reference/issues) directly from [MES](/docs/reference/mes).
+
+## MCP 2.0
+
+The [MCP server](/api/mcp) adds OAuth sign-in for AI clients.
+
+<Accordion title="Improvements">
+
+- Approvals: a lower-tier notification, a maximum amount, and notifications for rules with lower amounts.
+- Sales orders can be cancelled.
+- A post-login company picker for people in more than one company.
+- Attachments on purchase orders, and supplier part numbers on purchase order lines.
+- The sales order number on invoice PDFs.
+- A custom markup percentage in the quote line pricing dropdown.
+- Manually scheduled operations that the scheduler leaves alone.
+- Subassembly items show their item properties.
+- Location shown on the people table.
+- Long descriptions are editable again.
+
+</Accordion>
+
+<Accordion title="Fixes">
+
+- Storage rule messages name the storage unit instead of showing an id, and conditions accept value and label.
+- Rework quantities are subtracted on Complete all, and rework respects row-level security.
+- Negative adjustments work on serial items with legacy stock.
+- Dead tax fields on invoice totals fixed, and the upper bound on pricing approval corrected.
+- The job traveler PDF shows the correct time units.
+- List-type custom field values render in table columns.
+- Get Method respects checkbox selections when copying make methods.
+- Supplier and customer ids are consistent.
+
+</Accordion>
diff --git a/docs/content/changelog/2026-06-23-supersession-and-method-import.mdx b/docs/content/changelog/2026-06-23-supersession-and-method-import.mdx
new file mode 100644
index 0000000000..1fced78448
--- /dev/null
+++ b/docs/content/changelog/2026-06-23-supersession-and-method-import.mdx
@@ -0,0 +1,56 @@
+---
+title: "Picking lists, label printing, and item supersession"
+description: "Picking lists, label printing, item supersession, method import from CSV, and customizable document templates."
+date: "2026-06-23"
+tags: ["inventory", "items", "documents"]
+image: "/changelog/2026-06-23-supersession-and-method-import.svg"
+---
+
+Picking lists turn demand into a pick against real storage units, so the floor gets a list instead of a hunt.
+
+## Picking lists
+
+[Picking lists](/docs/reference/picking) turn demand into a pick against real storage units. Label [printing](/docs/reference/printing) ships alongside them.
+
+## Item supersession
+
+[Item supersession](/docs/reference/change-orders/supersession) records that a part is being phased out and which successor replaces it, so [planning](/docs/reference/planning) and job creation pick up the change.
+
+## Methods from CSV
+
+Bills of materials and bills of process can now be [imported from CSV](/docs/reference/import-export).
+
+## Document template customizer
+
+[Document templates](/docs/reference/documents) now have a customizer.
+
+<Accordion title="Improvements">
+
+- Duplicate a purchase order.
+- Inbound inspection for non-serial tracked items.
+- Sourcing type is an item-level property.
+- The import flow explains the Default row, clarifies Tracking Type, adds an optional unit cost, and lets value mappings be cleared.
+- The customer portal page was redesigned, with filtering.
+- Safety stock on the item planning chart, with clearer axis labels.
+- Field label tooltips, and tooltips for RFQ dates; the RFQ "Expiration Date" is now "Due Date".
+- Delete a 3D model from the viewer; the storage units tree opens expanded.
+- Copy the company id from company settings.
+- Document headings and body text follow the document theme.
+- Turkish translation.
+- MCP and self-hosting documentation.
+
+</Accordion>
+
+<Accordion title="Fixes">
+
+- CSV export respects the current saved view.
+- Purchase price updates on the invoice.
+- The packing slip is correct for warehouse transfer shipments.
+- Picking list line UI fixes.
+- Popover dropdowns scroll inside drawers and dialogs.
+- The employee group select pulls employees again.
+- Null unit costs no longer error; import writes unit cost and clears per-row errors.
+- Stale non-conformance descriptions refresh.
+- Label templates print correctly, including in the preview.
+
+</Accordion>
diff --git a/docs/content/changelog/2026-07-07-period-close-and-budgeting.mdx b/docs/content/changelog/2026-07-07-period-close-and-budgeting.mdx
new file mode 100644
index 0000000000..cd36f3b1d6
--- /dev/null
+++ b/docs/content/changelog/2026-07-07-period-close-and-budgeting.mdx
@@ -0,0 +1,52 @@
+---
+title: "Period closing, AR/AP payments, and company backups"
+description: "Close accounting periods, set budgets, reconcile bank statements, record payments, and back up or restore a company."
+date: "2026-07-07"
+tags: ["accounting", "settings"]
+image: "/changelog/2026-07-07-period-close-and-budgeting.svg"
+---
+
+Accounting got the pieces a month-end actually needs.
+
+## Period close, budgeting and bank reconciliation
+
+[Accounting](/docs/reference/accounting) gained [period closing](/docs/reference/period-close), budgeting and bank reconciliation, with drill-down from any account into the entries behind it.
+
+## AR and AP payments
+
+[Payments](/docs/reference/payments) record what customers pay you and what you pay your suppliers.
+
+## Company backups
+
+[Backups](/docs/platform/backups) export everything a company owns and restore it, with real progress and faster downloads.
+
+## Onboarding, revamped
+
+[Onboarding](/docs/reference/onboarding) was rebuilt around the Implementation Hub and a Setup Map, and a new company can start from [demo data](/docs/platform/demo-data).
+
+<Accordion title="Improvements">
+
+- Manufacturer Part Number on items.
+- An aggregated stock movements view.
+- Document templates support registration numbers, and PDFs auto-fill.
+- Supersession shows on material, tool, and consumable pages, with lifecycle badges and mode help.
+- Shift-select in tables, better inline editing, and CSV exports that respect the current view.
+- Download links for files.
+- Job order status tracks supply jobs and material shortfalls.
+- Self-hosting: auth providers are configurable from .env.
+
+</Accordion>
+
+<Accordion title="Fixes">
+
+- Quote-to-order financials are derived server-side, and quote acceptance is guarded against replay and stale status.
+- Invoice tax, the WIP ledger, editing production events, and dimension labels fixed.
+- Invoicing works without accounting enabled.
+- A job's shipped quantity is no longer overwritten on completion.
+- Negative adjustment errors surface in the modal.
+- File previews are authorized by company.
+- Backup restore hardening, and transient MRP tables are excluded from backups.
+- Auto-completed job operations record who completed them.
+- The number input allows direct typing.
+
+</Accordion>
diff --git a/docs/content/changelog/2026-07-21-inventory-valuation.mdx b/docs/content/changelog/2026-07-21-inventory-valuation.mdx
new file mode 100644
index 0000000000..1db142eac2
--- /dev/null
+++ b/docs/content/changelog/2026-07-21-inventory-valuation.mdx
@@ -0,0 +1,54 @@
+---
+title: "Change notices"
+description: "Draft an engineering change against real methods and review it as a diff. Plus inventory valuation and assembly instructions."
+date: "2026-07-21"
+tags: ["items", "accounting", "inventory"]
+image: "/changelog/2026-07-21-inventory-valuation.svg"
+---
+
+A design change usually touches several parts at once. Change notices let you revise them together and release them together.
+
+## Change notices
+
+A [change notice](/docs/reference/change-orders) groups the parts whose designs are changing, revises each one on a hidden draft, and releases them together. It answers what changed, who owns it, and what the new version supersedes, without touching a live method until release.
+
+Pick the affected items, edit each one's real bill of materials and bill of process inside the notice, review it as a diff with new part properties highlighted, and link issues to it. Change notices live under **Items → Change notices**.
+
+## Inventory valuation
+
+The inventory valuation report ties on-hand stock to the ledger, and [inventory](/docs/reference/inventory) adjustments post to the general ledger.
+
+## Service items and period close
+
+Service is now a first-class [item](/docs/reference/items) type. The accounting [period close](/docs/reference/period-close) has a full lifecycle, with a close checklist and posted-record immutability.
+
+<Accordion title="Improvements">
+
+- Assembly instructions on items.
+- Short-close purchase order lines, with partial goods-receipt visibility.
+- MES suggests a batch on issue and returns unused picks when a job completes.
+- Overhead absorption and account defaults improvements, with draft journals excluded from reports.
+- Raw materials and finished goods accounts.
+- Self-serve enrollment in the Implementation Hub.
+- A faster CAD pipeline with a progressive 3D viewer.
+- Top-level external notes are included in document emails.
+- Detail pages show the entity id in the breadcrumb.
+- Korean translation.
+- Academy: Engineering Change Orders video.
+
+</Accordion>
+
+<Accordion title="Fixes">
+
+- GAAP-correct journal entries for fixed asset registration and disposal.
+- Purchase price variance is no longer double-counted; the GL and cost subledger move together.
+- Default markup no longer overwrites set quote-line prices.
+- Subassemblies are scheduled by their item lead time.
+- Planning reads top-level demand projections.
+- Invoicing quantities are short-close aware.
+- Customer reference, salesperson, and engineering contact carry through to sales orders.
+- Selling a fixed asset no longer requires a method type.
+- The first tag can be created when none exist.
+- MES add-row suggestions prefer the pick-method order and clamp batch quantity.
+
+</Accordion>
diff --git a/docs/content/changelog/2026-08-04-stock-movement-corrections.mdx b/docs/content/changelog/2026-08-04-stock-movement-corrections.mdx
new file mode 100644
index 0000000000..93ffde46ba
--- /dev/null
+++ b/docs/content/changelog/2026-08-04-stock-movement-corrections.mdx
@@ -0,0 +1,62 @@
+---
+title: "Carbon agent, stock movement corrections, and notification preferences"
+description: "An AI agent inside Carbon, corrections for any posted stock movement, per-topic notification preferences, and per-item serial number sequences."
+date: "2026-08-04"
+tags: ["agent", "inventory", "settings"]
+image: "/changelog/2026-08-04-stock-movement-corrections.svg"
+---
+
+Carbon gained an agent that can act, not just answer.
+
+## The Carbon agent
+
+The [agent](/docs/reference/agent) answers questions and takes actions inside the app.
+
+## Corrections for posted stock movements
+
+Any posted stock movement can now be corrected with a linked correction row, which replaces count rectification. See [inventory](/docs/reference/inventory).
+
+## Per-topic notification preferences
+
+[Notification preferences](/docs/reference/notifications) are now per user and per topic, with email and Slack opt-outs.
+
+## Serial number sequences per item
+
+Serial number [sequences](/docs/reference/sequences) are configurable per item.
+
+## Change notices and assembly instructions
+
+[Change notices](/docs/reference/change-orders) gained an implementation lock, with reopen and links to [Linear](/docs/integrations/project-management) tasks.
+
+[Assembly instructions](/docs/reference/assembly-instructions) are versioned, and surfaced in change notice diffs.
+
+<Accordion title="Improvements">
+
+- MES: material picking with opt-in pre-select and an incomplete-pick policy, a Load Preview on the job-operation model tab, and NCR containment inspection steps created as needed in the assembly view.
+- Shop-floor assembly and inspection execution.
+- An opt-in materials section on the job traveler PDF, and total rows on the Estimates vs Actual card.
+- CSV bulk import for material properties, and the combined parts-with-methods import is back.
+- Released drawings and CAD models upload from Onshape.
+- Line-item shipping cost on the purchase order PDF, with corrected document totals.
+- Quick-filter toggles on inventory count lines.
+- Audit logs show related records and mark empty values.
+- Backups are available to non-internal users on self-hosted installs.
+- The accounting module is internationalized.
+- Academy: redesigned, with a Work Instructions and Process Types lesson.
+
+</Accordion>
+
+<Accordion title="Fixes">
+
+- Jobs cannot be created with zero quantity, and a job can re-link to a sales order line.
+- Receipts: posting is blocked on voided receipts and the Pending transition is atomic.
+- Bin-to-bin batch transfers no longer consume the lot; the transfer wizard was redesigned.
+- Invoice due dates recompute when the issue date or payment term changes.
+- MES: fractional quantities in the operation quantity modal, expired lots excluded from FEFO suggestions, picked remainders return to the actual pick bin, and work instructions render step images.
+- Passkey sign-in fails safely on a company lookup error and shows the company picker for multi-company users.
+- Digital quote lines can be deselected and removed wherever they are selectable.
+- Line tax percent shows two decimals; the job traveler BOM header stays attached across page breaks.
+- Notification recipients who left the company are dropped.
+- Onshape OAuth failures are surfaced on the integrations page.
+
+</Accordion>
diff --git a/docs/content/changelog/2026-08-18-accounting-sync-engine.mdx b/docs/content/changelog/2026-08-18-accounting-sync-engine.mdx
new file mode 100644
index 0000000000..92ed0795fa
--- /dev/null
+++ b/docs/content/changelog/2026-08-18-accounting-sync-engine.mdx
@@ -0,0 +1,54 @@
+---
+title: "Automation workflows"
+description: "Build automations on a canvas from a trigger, conditions, and steps. Plus accounting sync for Xero, QuickBooks, and Rillet."
+date: "2026-08-18"
+tags: ["workflows", "accounting", "mes"]
+image: "/changelog/2026-08-18-accounting-sync-engine.svg"
+---
+
+Plenty happens in Carbon that ought to set something else in motion: a sales order changing hands, a job going on hold. Workflows let you wire that up yourself.
+
+## Automation workflows
+
+A [workflow](/docs/reference/workflows) watches for something happening in Carbon and then does something about it: notify the account manager when a sales order changes hands, open an issue when a job is put on hold, or call your own service when a shipment is posted.
+
+Build one on a canvas under **Automate → Workflows** and press Publish. Steps are cards you connect by their handles, so one trigger can fan out into branches. Every run is recorded step by step.
+
+## Accounting sync and financial reports
+
+Carbon can sync accounting data to Xero, QuickBooks Online and Rillet through one [multi-provider sync engine](/docs/integrations/accounting), and a [financial reports](/docs/reference/financial-reports) module arrives with it.
+
+Multi-entity companies get a capture-driven [intercompany](/docs/reference/intercompany) elimination engine: intercompany invoices are posted, matched and eliminated automatically, and consolidated reports show the group without double-counted internal trade.
+
+## Scrap and unscrap
+
+[Scrap](/docs/reference/scrap) serials and subcomponents from [MES](/docs/reference/mes) or stock from the ERP, with a scrap-reason [dimension](/docs/reference/dimensions). Unscrap restores a scrapped part at its original cost.
+
+<Accordion title="Improvements">
+
+- TOTP two-factor authentication, with org-level enforcement.
+- MES work center displays, and board and list views for the assigned-to-me page.
+- Business dates follow the company and location timezones, with a shared date-time control and a searchable timezone picker.
+- Picked-material return timing (at job or operation), and batch splits keep the parent's identity.
+- An ITAR certification system covers entity and user certifications, with hardened invites.
+- A platform-wide numeric precision and formatting standard. Per-unit prices keep the digits they were typed with.
+- Search modal filter chips are ordered by likely use.
+- The guides carry real product screenshots.
+
+</Accordion>
+
+<Accordion title="Fixes">
+
+- Quote line prices are rewritten in a transaction, preserve shipping cost, and an empty rewrite is a no-op.
+- Base-currency pricing shows in the base currency on quotes and sales order lines; supplier quotes compare in the base currency.
+- Sales order totals no longer collapse equal line amounts.
+- Invoice due dates handle End of Month and Day of Month payment terms and populate from the payment term on posting.
+- Picking lists honor item supersession, and the default bin is read for the right item.
+- Item quantities update in real time, alongside MRP correctness fixes; planning scrap math and MRP double-netting corrected.
+- Schedule board updates commit on drop, and pre-assigned work centers survive a reschedule.
+- MES: the serial picker only shows for serial parts, multiple batches can be unconsumed, and job operation files are reachable on mobile.
+- Issues appear in global search; duplicate issue type names are prevented.
+- Change notice notifications go to assignees instead of the whole company.
+- Audit log diffs show display names instead of raw ids.
+
+</Accordion>
diff --git a/docs/content/changelog/2026-09-04-finite-capacity-scheduling.mdx b/docs/content/changelog/2026-09-04-finite-capacity-scheduling.mdx
new file mode 100644
index 0000000000..a36a20cfc1
--- /dev/null
+++ b/docs/content/changelog/2026-09-04-finite-capacity-scheduling.mdx
@@ -0,0 +1,50 @@
+---
+title: "Finite-capacity scheduling"
+description: "The scheduler now plans against real work-center capacity, with ability-gated operators and an explainable Gantt."
+date: "2026-09-04"
+tags: ["production", "settings", "accounting"]
+image: "/changelog/2026-09-04-finite-capacity-scheduling.svg"
+---
+
+Scheduling used to assume infinite machines and people. It now plans against the capacity you actually have.
+
+## Finite-capacity scheduling
+
+The [scheduler](/docs/reference/scheduling) reserves capacity on an operation's [work center](/docs/reference/work-centers), and operators are gated by the abilities a job operation requires.
+
+The Gantt explains its placements, so you can see why an operation landed where it did instead of guessing.
+
+## Enterprise SAML SSO
+
+Carbon now supports [SAML single sign-on](/docs/reference/single-sign-on), so your team can sign in through your identity provider. Account linking is provider-agnostic, and the configuration lives in **Settings → Security**.
+
+[Two-factor enforcement](/docs/reference/two-factor) is also now available on the Business plan.
+
+## Platform exchange rates
+
+Currency exchange rates are now managed platform-globally, with per-company overrides when your company needs to pin its own rate.
+
+The [chart of accounts](/docs/reference/accounting) also gained an opening-balances tool for bringing existing books into Carbon.
+
+<Accordion title="Improvements">
+
+- Jobs can copy their method from another job, with a version picker for choosing which method revision to source.
+- A BOM-level replenishment system and purchasing units of measure.
+- API keys can opt in to an accounting delete scope.
+- A refreshed app shell for ERP and MES with an inset, floating layout, plus responsive mobile navigation.
+- CSV import for storage units, with validation that rejects cross-location and name-colliding rows.
+- Item IDs may now be lowercase, and chart-of-accounts account mapping covers the full chart.
+- Purchase order PDFs show the company EORI number below the VAT number.
+- Onboarding now presents the Starter, Business, and Enterprise plans.
+
+</Accordion>
+
+<Accordion title="Fixes">
+
+- Item supersession swaps now resolve correctly across every job-creation flow, so a phased-out part's successor is substituted consistently.
+- The schedule no longer reopens finished operations when a location's schedule is regenerated.
+- Items with inventory or cost history can no longer be deleted out from under their records.
+- Posting a purchase invoice no longer marks it paid.
+- MES shows the item revision in the operation header, and an unconverted 3D model renders as a slide instead of a load error.
+
+</Accordion>
diff --git a/docs/content/changelog/2026-09-18-returns-batching-and-the-carbon-api.mdx b/docs/content/changelog/2026-09-18-returns-batching-and-the-carbon-api.mdx
new file mode 100644
index 0000000000..7b85439544
--- /dev/null
+++ b/docs/content/changelog/2026-09-18-returns-batching-and-the-carbon-api.mdx
@@ -0,0 +1,72 @@
+---
+title: "Returns, operation batching, and the Carbon API"
+description: "Customer RMAs and supplier returns, job operations that run as one batch, and the Carbon API over plain HTTP."
+date: "2026-09-18"
+tags: ["sales", "purchasing", "production", "mes", "api"]
+image: "/changelog/2026-09-18-returns-batching-and-the-carbon-api.svg"
+---
+
+Returns now have a home of their own, on both sides of the business.
+
+## Customer RMAs
+
+A [customer RMA](/docs/reference/rmas) authorizes what a customer may send back. Its lines point at the [sales order](/docs/reference/sales-orders), [shipment](/docs/reference/shipments) or [invoice](/docs/reference/invoices) lines they reverse, and the picker only offers quantities that have actually shipped and have not already been authorized.
+
+Receiving one goes through the same [receipts](/docs/reference/receipts) flow as a purchase order, and a customizable PDF is generated when the RMA is confirmed.
+
+## Supplier returns
+
+[Supplier returns](/docs/reference/supplier-returns) work the other way round: send received goods back to a supplier, keeping serial or batch identity, claim the credit, and raise a replacement purchase order.
+
+## Job operation batching
+
+Operations from several jobs can now run together as one [batch](/docs/reference/batching): a heat-treat load, a plating tank, an oven cycle.
+
+Mark a process as batchable, say whether members run sequentially or simultaneously, and set compatibility rules and a [work center](/docs/reference/work-centers) capacity limit. Batches are created, reviewed, released, moved and dissolved from the Batches list, and each one prints a load sheet.
+
+Releasing a batch schedules it as a single capacity reservation. Completing it shares one timer across its members, with time and cost allocated proportionally.
+
+## The Carbon API
+
+All 1,481 of Carbon's service operations are now reachable at `POST /api/v1/{module}/{operation}`, with an OpenAPI 3 spec at `/api/v1/openapi.json`. The [API docs](/api) have been rebuilt around it.
+
+The MCP server, the in-app [agent](/docs/reference/agent) and workflow actions all run through this same layer, so the per-operation scope check on an [API key](/docs/building/api-keys) is enforced once, the same way, for every caller.
+
+## Keyboard shortcuts everywhere
+
+Press `?` on any page to see every shortcut available there. Save any form with Cmd+Enter, press `n` to add a record on a list page, `g` then a letter to jump to a module, and Space to start or pause an operation on the [shop floor](/docs/reference/mes).
+
+Buttons show a small keycap badge for their shortcut, with the right symbol for your platform.
+
+<Accordion title="Improvements">
+
+- [Bulk CSV import](/docs/reference/import-export) for quotes (whole quotes with lines, headers only, or lines added to existing quotes), plus six new import types: services, units of measure, item groups, storage types, scrap reasons, and departments. The BOM export now includes item attributes, the parts export is importable as-is, and leaving an import in progress asks before discarding it.
+- A **Transfer** [kanban](/docs/reference/kanban) type alongside Buy and Make: scanning it creates a stock transfer from one storage unit to another for the kanban's quantity.
+- Early-payment discounts post as a reduction of revenue for customers and a reduction of cost for suppliers, rather than as an operating expense, the same way a credit memo already did.
+- The Rillet integration can import customers and vendors, so an invoice raised in Carbon updates the existing Rillet record instead of creating a second one. The Stripe Connect panel now walks through setup.
+- Supplier and customer records gained a Documents tab, for files that belong to the company itself rather than to any one order, and a Bank Accounts tab whose fields adapt to the country (IBAN for France, IFSC plus SWIFT for India) with checksum validation.
+- [Sales rules](/docs/reference/sales-rules): if-this-then-block-or-warn rules that fire when an item is added to a quote, sales order, or invoice line, built on the same engine as storage rules.
+- Item supersession's **Consume First** mode now runs end to end. Job creation, planning, picking, and consumption all agree on the old part's stock, a unit never mixes old and new parts, and you can add a predecessor from the successor's side. A supersession loop is refused instead of silently dropping both rules.
+- An ability is now created from a process and takes its name from it, so renaming the process renames the qualification.
+- The Bill of Process preview shows every step's slides, with annotation pins aligned to the image.
+- Photos taken on an iPhone are converted from HEIC to JPEG at upload, and every image upload runs through one shared pipeline.
+- MCP tools can attach files to jobs, items, opportunities, and supplier interactions.
+- Self-hosted: app email is sent over SMTP using the same `SMTP_*` variables Supabase Auth uses. An existing Resend key keeps working as a fallback.
+- Carbon Cloud: self-signup from free or disposable email domains is declined, whether by email or through Google and Outlook sign-in.
+- Pages load faster. The translation catalog is served as a cached static chunk, and the app shell no longer downloads whole tables in the browser.
+
+</Accordion>
+
+<Accordion title="Fixes">
+
+- Sales orders report the amount actually paid: voided invoices are excluded and partial payments count.
+- Paperless Parts webhooks are verified against the raw request body, and their errors are logged instead of swallowed.
+- Saving one integration secret no longer wipes the others.
+- A unit of measure that is still in use can no longer be deleted.
+- Completing a serial job receives exactly the quantity completed, and the outside-operation supplier is resolved from the process when a job is released.
+- Issue disposition quantities are editable, and changing an issue task's status or assignee requires the quality permission.
+- Re-inviting a user whose invitation was revoked works again, and a permission failure now shows an error instead of doing nothing.
+- Forecast rows are labelled by part rather than operation description, and an existing purchase order line is no longer listed twice in the supply and demand card.
+- Onshape sync uses the exact released part identity, and legacy invoice settlements without a document principal read correctly.
+
+</Accordion>
diff --git a/docs/content/changelog/2026-09-28-ramp-batch-materials-and-community-planning.mdx b/docs/content/changelog/2026-09-28-ramp-batch-materials-and-community-planning.mdx
new file mode 100644
index 0000000000..3f34804cdb
--- /dev/null
+++ b/docs/content/changelog/2026-09-28-ramp-batch-materials-and-community-planning.mdx
@@ -0,0 +1,69 @@
+---
+title: "Ramp card transactions, batch materials, and a larger community edition"
+description: "Ramp card spend flows into the ledger, batches share materials, and planning and accounting join the community edition."
+date: "2026-09-28"
+tags: ["accounting", "production", "sales", "settings", "auth"]
+image: "/changelog/2026-09-28-ramp-batch-materials-and-community-planning.svg"
+---
+
+Carbon can now act as Ramp's accounting provider, so card spend, bills and reimbursements land in the general ledger instead of a spreadsheet.
+
+## Ramp card transactions
+
+Connect the [Ramp integration](/docs/integrations/accounting) and Carbon pushes its chart of accounts and cost centers across, then pulls card transactions, transfers, cashbacks, repayments, bills, reimbursements and payments back.
+
+Card spend arrives as a card transaction document (Draft, Posted or Voided) that posts into the general ledger. Bills and payments flow through accounts payable, and Carbon's [purchase orders](/docs/reference/purchase-orders) and posted [invoices](/docs/reference/invoices) go out to Ramp for bill matching.
+
+Sync Activity shows every record's outcome, and the integration panel reports its health.
+
+## Batches share materials and plan their output
+
+The second half of [operation batching](/docs/reference/batching). Issuing a lot-tracked material to a batch now splits it across the member jobs in proportion to what each still needs: one trip to the shelf, one consumption record per job.
+
+Output lots are planned when the batch is built, either one per member or a single combined lot, so the operator never types a lot number at completion. Jobs are still never merged: costing and genealogy stay per job throughout.
+
+## Quotes predict lead time from the schedule
+
+A **Predict** button on the [quote](/docs/reference/quotes) line pricing grid runs the line's routing through the [finite scheduler](/docs/reference/scheduling) without saving anything.
+
+It answers for every quantity break: **End of queue** behind released work, **Best case** with open jobs excluded, or against a **Target date**, telling you whether the line lands on time, only by expediting, or not even then.
+
+## Demo data for everyone
+
+Every new signup now gets a "How would you like to start?" step in [onboarding](/docs/reference/onboarding), and can begin with an industry [demo company](/docs/platform/demo-data) instead of an empty one.
+
+The data fills every major ERP and MES screen with documents in every status a user can reach. Posted documents carry the ledger entries and stock movements real posting would create, and [planning](/docs/reference/planning) and scheduling run right after it lands, so the shop floor is scheduled rather than blank.
+
+## A larger community edition
+
+Material planning (MRP and the finite scheduler), the configurator rules engine, and accounting are now part of the community edition under AGPLv3.
+
+Every commercial feature's code now lives in one place, `packages/ee`, so the boundary between the editions is the boundary in the source tree. See [licensing](/docs/platform/licensing) for what each edition includes.
+
+<Accordion title="Improvements">
+
+- The 3D assembly viewer can see past parts that are already fitted, with four named views (**Build**, **Focus**, **Isolate**, and **Full**) in both the ERP assembly editor and the MES shop-floor screen.
+- Each company's files now live in their own storage bucket. Backups restored into a different company come back whole: items keep their part numbers and 3D assemblies load.
+- Default accounts can be exported as CSV.
+- The Bill of Process preview shows pin labels and tool descriptions.
+- Login pages on Carbon Cloud use Vercel BotID for bot protection. Self-hosted instances choose between BotID and Turnstile with `BOT_PROTECTION`.
+- Self-hosted: setting `ADMIN_EMAIL` seeds the instance admin's account on a fresh install, and the first admin of an empty instance can reach onboarding.
+- Security hardening: tenant scoping on every path that does not go through row-level security, webhook and OAuth verification that fails closed, hashed MES console PINs (operators pin in again once after the deploy), uploaded SVG and HTML served as downloads, and cross-site request forgery protection with a report-only content security policy.
+- Page headlines are set in Hedvig Letters Serif.
+- The item sales rules card moved to the Sales tab, and unit of measure is editable on consumables and tools.
+
+</Accordion>
+
+<Accordion title="Fixes">
+
+- Completing a job completes its operation quantities, and estimates vs. actual shows the real completed quantity.
+- Completing a serial job from the desk no longer asks for serial numbers it already has.
+- A forced logout now says why instead of failing silently.
+- Tracked lots keep their quantities honest: values are rounded when stored so float residue never reaches the ledger, stock-transfer picks are idempotent, adjustments and counts can no longer leave a zero or negative Available lot, and the MES Complete Batch grid accepts decimals.
+- A receipt's batch-tracking status settles with its quantity, and the stock transfer wizard shows negative storage-unit balances instead of hiding them.
+- The item planning chart includes demand projections.
+- Large backup uploads no longer fail with Request Entity Too Large.
+- MES operation cards open again for companies with a copied twin, and batch numbers are searchable on the shop-floor board.
+- Material edits made over MCP save and follow the properties panel's rules.
+
+</Accordion>
diff --git a/docs/lib/changelog-feed-components.tsx b/docs/lib/changelog-feed-components.tsx
new file mode 100644
index 0000000000..6b83434b01
--- /dev/null
+++ b/docs/lib/changelog-feed-components.tsx
@@ -0,0 +1,66 @@
+import { createElement, Fragment, type ReactNode } from "react";
+import { SITE } from "@/lib/seo";
+
+/* What a changelog entry's MDX becomes inside the RSS feed.
+ *
+ * Feed readers and email clients run no components and load no stylesheets, so every
+ * editorial component an entry may use needs a plain-HTML stand-in here. A component
+ * with no entry in this map renders as `undefined` and FAILS THE BUILD — that is
+ * deliberate: a newsletter that silently drops a section is worse than a broken build.
+ * Adding a component to the changelog's vocabulary means adding its degrade here. */
+
+type Props = { children?: ReactNode };
+
+function absoluteUrl(href: string | undefined): string | undefined {
+ // Feed readers have no page URL to resolve site-relative links against.
+ return href?.startsWith("/") ? `${SITE.url}${href}` : href;
+}
+
+function el(tag: string, props: Record<string, unknown> | null, ...kids: ReactNode[]) {
+ return createElement(tag, props, ...kids);
+}
+
+export const FEED_COMPONENTS = {
+ a: ({ href, children }: Props & { href?: string }) =>
+ el("a", { href: absoluteUrl(href) }, children),
+
+ Accordion: ({ title, children }: Props & { title: string }) =>
+ createElement(Fragment, null, el("h3", null, title), children),
+
+ // Same shape the page gives it: a titled section, not a collapsed aside.
+ Callout: ({ title, children }: Props & { type?: string; title?: ReactNode }) =>
+ el("blockquote", null, title ? el("p", null, el("strong", null, title)) : null, children),
+
+ Steps: ({ children }: Props) => el("ol", null, children),
+ Step: ({ children }: Props) => el("li", null, children),
+
+ Cards: ({ children }: Props) => el("ul", null, children),
+ Card: ({ title, href, children }: Props & { title?: ReactNode; href?: string }) =>
+ el(
+ "li",
+ null,
+ href ? el("a", { href: absoluteUrl(href) }, el("strong", null, title)) : el("strong", null, title),
+ children ? el(Fragment as never, null, " — ", children) : null
+ ),
+
+ // `label` is the alt text; an unfilled slot has no image to send, so only its
+ // caption travels rather than a dangling <img>.
+ Screenshot: ({ src, label, caption }: { src?: string; label: string; caption?: string }) =>
+ el(
+ "figure",
+ null,
+ src ? el("img", { src: absoluteUrl(src), alt: label }) : null,
+ caption ? el("figcaption", null, caption) : null
+ ),
+
+ // A Figure is an inline SVG diagram; it cannot survive a mail client, so it
+ // degrades to its caption alone.
+ Figure: ({ caption }: { illustration?: string; caption?: string }) =>
+ caption ? el("p", null, el("em", null, caption)) : null,
+
+ PlanBadge: ({ plan = "Business" }: { plan?: string }) =>
+ el("em", null, `(Available on the ${plan} plan)`),
+
+ // Glossary tooltips are page-only; the word itself is what matters.
+ Term: ({ children }: Props) => createElement(Fragment, null, children),
+};
diff --git a/docs/lib/changelog.ts b/docs/lib/changelog.ts
new file mode 100644
index 0000000000..66dd2de8b4
--- /dev/null
+++ b/docs/lib/changelog.ts
@@ -0,0 +1,41 @@
+// Entry dates are formatted from their YYYY-MM-DD parts, never through a JS
+// Date, so every timezone sees the date the entry was written with.
+
+const MONTHS = [
+ "January",
+ "February",
+ "March",
+ "April",
+ "May",
+ "June",
+ "July",
+ "August",
+ "September",
+ "October",
+ "November",
+ "December",
+] as const;
+
+/** "2026-09-04" → "September 4, 2026". */
+export function formatChangelogDate(date: string): string {
+ const [y, m, d] = date.split("-").map(Number);
+ return `${MONTHS[(m ?? 1) - 1]} ${d}, ${y}`;
+}
+
+// "2026-09-04" → "04 Sep 2026 00:00:00 GMT" (RFC 822, for RSS).
+export function rfc822Date(date: string): string {
+ const [y, m, d] = date.split("-").map(Number);
+ const day = String(d).padStart(2, "0");
+ return `${day} ${MONTHS[(m ?? 1) - 1].slice(0, 3)} ${y} 00:00:00 GMT`;
+}
+
+export function escapeXml(value: string): string {
+ return value
+ .replaceAll("&", "&amp;")
+ .replaceAll("<", "&lt;")
+ .replaceAll(">", "&gt;")
+ .replaceAll('"', "&quot;")
+ .replaceAll("'", "&apos;");
+}
+
+export const RSS_ITEM_LIMIT = 20;
diff --git a/docs/lib/search-index.ts b/docs/lib/search-index.ts
index 85e31ff595..50c4bf49d6 100644
--- a/docs/lib/search-index.ts
+++ b/docs/lib/search-index.ts
@@ -7,7 +7,7 @@ import {
glossaryEntries,
termSlug,
} from "@carbon/content/glossary";
-import { guideSource, source } from "@/lib/source";
+import { changelogSource, guideSource, source } from "@/lib/source";
import { operationLabel, toolModules } from "@/lib/tools-data";
const GLOSSARY_URL = "/docs/glossary";
@@ -175,6 +175,8 @@ export function buildSearchIndexes(): AdvancedIndex[] {
...mdxIndexes(otherDocs, "docs", "Reference"),
...(glossaryPage ? [glossaryIndex(glossaryPage)] : []),
...mdxIndexes(guideSource.getPages(), "guide", "Guide"),
+ // No pill of its own; entries show under All.
+ ...mdxIndexes(changelogSource.getPages(), "changelog", "Changelog"),
...resourceIndexes(),
...toolIndexes(),
];
diff --git a/docs/lib/source.ts b/docs/lib/source.ts
index 6ce24de406..28b2bfcfac 100644
--- a/docs/lib/source.ts
+++ b/docs/lib/source.ts
@@ -1,4 +1,4 @@
-import { docs, guide } from "collections/server";
+import { changelog, docs, guide } from "collections/server";
import { loader } from "fumadocs-core/source";
export const source = loader({
@@ -10,3 +10,15 @@ export const guideSource = loader({
baseUrl: "/guides",
source: guide.toFumadocsSource(),
});
+
+export const changelogSource = loader({
+ baseUrl: "/changelog",
+ source: changelog.toFumadocsSource(),
+});
+
+// Newest first by frontmatter `date`; filename order breaks ties.
+export function getChangelogEntries() {
+ return [...changelogSource.getPages()].sort((a, b) =>
+ b.data.date.localeCompare(a.data.date)
+ );
+}
diff --git a/docs/package.json b/docs/package.json
index b10160f582..79701e6d69 100644
--- a/docs/package.json
+++ b/docs/package.json
@@ -12,7 +12,8 @@
"lint": "biome lint --write .",
"format": "biome format --write .",
"check": "biome check --write .",
- "typecheck": "node scripts/generate-api-docs.mjs && fumadocs-mdx && tsc --noEmit"
+ "typecheck": "node scripts/generate-api-docs.mjs && fumadocs-mdx && tsc --noEmit",
+ "generate:changelog-thumbnails": "node scripts/generate-changelog-thumbnail.mjs"
},
"dependencies": {
"@carbon/content": "workspace:*",
diff --git a/docs/public/changelog/2026-03-31-time-clock-and-quality-dashboard.svg b/docs/public/changelog/2026-03-31-time-clock-and-quality-dashboard.svg
new file mode 100644
index 0000000000..17c2eab71f
--- /dev/null
+++ b/docs/public/changelog/2026-03-31-time-clock-and-quality-dashboard.svg
@@ -0,0 +1,37 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 675" fill="none">
+ <rect width="1200" height="675" fill="#09090B"/>
+ <rect x="150" y="180" width="470" height="316" rx="16" fill="#141518" stroke="#26272B" stroke-width="1.5"/>
+ <path d="M150 226 H620" stroke="#26272B" stroke-width="1.5"/>
+ <circle cx="178" cy="203" r="4" fill="#2E3036"/>
+ <circle cx="196" cy="203" r="4" fill="#2E3036"/>
+ <circle cx="214" cy="203" r="4" fill="#2E3036"/>
+ <rect x="184" y="268" width="150" height="16" rx="8" fill="#00B0FF"/>
+ <rect x="184" y="306" width="224" height="10" rx="5" fill="#2E3036"/>
+ <rect x="184" y="338" width="178" height="10" rx="5" fill="#2E3036"/>
+ <path d="M150 374 H620" stroke="#212329" stroke-width="1.5"/>
+ <circle cx="198" cy="410" r="4" fill="#3FB950"/>
+ <rect x="218" y="405" width="169" height="9" rx="4" fill="#2E3036"/>
+ <circle cx="198" cy="440" r="4" fill="#3FB950"/>
+ <rect x="218" y="435" width="185" height="9" rx="4" fill="#2E3036"/>
+ <circle cx="198" cy="470" r="4" fill="#D29922"/>
+ <rect x="218" y="465" width="157" height="9" rx="4" fill="#2E3036"/>
+ <rect x="660" y="180" width="392" height="316" rx="16" fill="#141518" stroke="#26272B" stroke-width="1.5"/>
+ <rect x="688" y="214" width="168" height="80" rx="12" fill="#1B1C20" stroke="#26272B" stroke-width="1.5"/>
+ <rect x="872" y="214" width="152" height="80" rx="12" fill="#1B1C20" stroke="#26272B" stroke-width="1.5"/>
+ <rect x="708" y="238" width="57" height="14" rx="7" fill="#00B0FF"/>
+ <rect x="708" y="264" width="111" height="8" rx="4" fill="#2E3036"/>
+ <rect x="892" y="238" width="60" height="14" rx="7" fill="#43454D"/>
+ <rect x="892" y="264" width="89" height="8" rx="4" fill="#2E3036"/>
+ <rect x="688" y="314" width="168" height="80" rx="12" fill="#1B1C20" stroke="#26272B" stroke-width="1.5"/>
+ <rect x="872" y="314" width="152" height="80" rx="12" fill="#1B1C20" stroke="#26272B" stroke-width="1.5"/>
+ <rect x="708" y="338" width="71" height="14" rx="7" fill="#43454D"/>
+ <rect x="708" y="364" width="109" height="8" rx="4" fill="#2E3036"/>
+ <rect x="892" y="338" width="53" height="14" rx="7" fill="#43454D"/>
+ <rect x="892" y="364" width="99" height="8" rx="4" fill="#2E3036"/>
+ <rect x="688" y="414" width="168" height="80" rx="12" fill="#1B1C20" stroke="#26272B" stroke-width="1.5"/>
+ <rect x="872" y="414" width="152" height="80" rx="12" fill="#1B1C20" stroke="#26272B" stroke-width="1.5"/>
+ <rect x="708" y="438" width="71" height="14" rx="7" fill="#43454D"/>
+ <rect x="708" y="464" width="106" height="8" rx="4" fill="#2E3036"/>
+ <rect x="892" y="438" width="60" height="14" rx="7" fill="#43454D"/>
+ <rect x="892" y="464" width="91" height="8" rx="4" fill="#2E3036"/>
+</svg>
diff --git a/docs/public/changelog/2026-04-14-passkeys.svg b/docs/public/changelog/2026-04-14-passkeys.svg
new file mode 100644
index 0000000000..8d13cc6fdf
--- /dev/null
+++ b/docs/public/changelog/2026-04-14-passkeys.svg
@@ -0,0 +1,28 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 675" fill="none">
+ <rect width="1200" height="675" fill="#09090B"/>
+ <rect x="390" y="158" width="420" height="360" rx="20" fill="#141518" stroke="#26272B" stroke-width="1.5"/>
+ <path d="M390 204 H810" stroke="#26272B" stroke-width="1.5"/>
+ <circle cx="418" cy="181" r="4" fill="#2E3036"/>
+ <circle cx="436" cy="181" r="4" fill="#2E3036"/>
+ <circle cx="454" cy="181" r="4" fill="#2E3036"/>
+ <circle cx="600" cy="300" r="34" fill="none" stroke="#00B0FF" stroke-width="1.5"/>
+ <circle cx="600" cy="300" r="62" fill="none" stroke="#26272B" stroke-width="1.5"/>
+ <circle cx="600" cy="300" r="90" fill="none" stroke="#26272B" stroke-width="1.5"/>
+ <circle cx="600" cy="300" r="10" fill="#00B0FF"/>
+ <rect x="444" y="404" width="312" height="10" rx="5" fill="#2E3036"/>
+ <rect x="444" y="436" width="236" height="10" rx="5" fill="#2E3036"/>
+ <rect x="444" y="470" width="312" height="30" rx="8" fill="#0B3C50"/>
+ <rect x="460" y="478" width="120" height="14" rx="7" fill="#00B0FF"/>
+ <rect x="160" y="236" width="190" height="204" rx="14" fill="#1B1C20" stroke="#26272B" stroke-width="1.5"/>
+ <rect x="186" y="270" width="94" height="10" rx="5" fill="#43454D"/>
+ <rect x="186" y="298" width="130" height="8" rx="4" fill="#2E3036"/>
+ <rect x="186" y="334" width="123" height="8" rx="4" fill="#212329"/>
+ <rect x="186" y="362" width="110" height="8" rx="4" fill="#212329"/>
+ <rect x="186" y="390" width="94" height="8" rx="4" fill="#212329"/>
+ <rect x="850" y="236" width="190" height="204" rx="14" fill="#1B1C20" stroke="#26272B" stroke-width="1.5"/>
+ <rect x="876" y="270" width="82" height="10" rx="5" fill="#43454D"/>
+ <rect x="876" y="298" width="126" height="8" rx="4" fill="#2E3036"/>
+ <rect x="876" y="334" width="109" height="8" rx="4" fill="#212329"/>
+ <rect x="876" y="362" width="107" height="8" rx="4" fill="#212329"/>
+ <rect x="876" y="390" width="97" height="8" rx="4" fill="#212329"/>
+</svg>
diff --git a/docs/public/changelog/2026-04-28-inventory-storage.svg b/docs/public/changelog/2026-04-28-inventory-storage.svg
new file mode 100644
index 0000000000..0fcbce88a5
--- /dev/null
+++ b/docs/public/changelog/2026-04-28-inventory-storage.svg
@@ -0,0 +1,30 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 675" fill="none">
+ <rect width="1200" height="675" fill="#09090B"/>
+ <rect x="190" y="166" width="470" height="392" rx="16" fill="#141518" stroke="#26272B" stroke-width="1.5"/>
+ <path d="M190 212 H660" stroke="#26272B" stroke-width="1.5"/>
+ <circle cx="218" cy="189" r="4" fill="#2E3036"/>
+ <circle cx="236" cy="189" r="4" fill="#2E3036"/>
+ <circle cx="254" cy="189" r="4" fill="#2E3036"/>
+ <rect x="224" y="242" width="20" height="20" rx="5" fill="#0B3C50" stroke="#00B0FF" stroke-width="1.5"/>
+ <rect x="260" y="246" width="166" height="9" rx="4" fill="#43454D"/>
+ <rect x="548" y="246" width="54" height="9" rx="4" fill="#2E3036"/>
+ <rect x="224" y="300" width="20" height="20" rx="5" fill="#0B3C50" stroke="#00B0FF" stroke-width="1.5"/>
+ <rect x="260" y="304" width="190" height="9" rx="4" fill="#43454D"/>
+ <rect x="548" y="304" width="56" height="9" rx="4" fill="#2E3036"/>
+ <rect x="224" y="358" width="20" height="20" rx="5" fill="none" stroke="#43454D" stroke-width="1.5"/>
+ <rect x="260" y="362" width="171" height="9" rx="4" fill="#2E3036"/>
+ <rect x="548" y="362" width="53" height="9" rx="4" fill="#2E3036"/>
+ <rect x="224" y="416" width="20" height="20" rx="5" fill="none" stroke="#43454D" stroke-width="1.5"/>
+ <rect x="260" y="420" width="159" height="9" rx="4" fill="#2E3036"/>
+ <rect x="548" y="420" width="72" height="9" rx="4" fill="#2E3036"/>
+ <rect x="224" y="474" width="20" height="20" rx="5" fill="none" stroke="#43454D" stroke-width="1.5"/>
+ <rect x="260" y="478" width="151" height="9" rx="4" fill="#2E3036"/>
+ <rect x="548" y="478" width="60" height="9" rx="4" fill="#2E3036"/>
+ <path d="M712 300 H772 M712 420 H772" stroke="#43454D" stroke-width="1.5" stroke-dasharray="5 7"/>
+ <rect x="790" y="246" width="240" height="108" rx="14" fill="#1B1C20" stroke="#26272B" stroke-width="1.5"/>
+ <rect x="818" y="278" width="110" height="10" rx="5" fill="#43454D"/>
+ <rect x="818" y="306" width="164" height="8" rx="4" fill="#2E3036"/>
+ <rect x="790" y="386" width="240" height="108" rx="14" fill="#141518" stroke="#00B0FF" stroke-width="1.5"/>
+ <rect x="818" y="418" width="96" height="12" rx="6" fill="#00B0FF"/>
+ <rect x="818" y="448" width="152" height="8" rx="4" fill="#2E3036"/>
+</svg>
diff --git a/docs/public/changelog/2026-05-12-item-constraint-rules.svg b/docs/public/changelog/2026-05-12-item-constraint-rules.svg
new file mode 100644
index 0000000000..b007ef05f6
--- /dev/null
+++ b/docs/public/changelog/2026-05-12-item-constraint-rules.svg
@@ -0,0 +1,28 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 675" fill="none">
+ <rect width="1200" height="675" fill="#09090B"/>
+ <rect x="170" y="152" width="480" height="180" rx="16" fill="#141518" stroke="#26272B" stroke-width="1.5"/>
+ <path d="M170 198 H650" stroke="#26272B" stroke-width="1.5"/>
+ <circle cx="198" cy="175" r="4" fill="#2E3036"/>
+ <circle cx="216" cy="175" r="4" fill="#2E3036"/>
+ <circle cx="234" cy="175" r="4" fill="#2E3036"/>
+ <rect x="204" y="224" width="161" height="9" rx="4" fill="#2E3036"/>
+ <rect x="520" y="224" width="71" height="9" rx="4" fill="#43454D"/>
+ <rect x="204" y="258" width="139" height="9" rx="4" fill="#2E3036"/>
+ <rect x="520" y="258" width="64" height="9" rx="4" fill="#43454D"/>
+ <rect x="170" y="362" width="480" height="180" rx="16" fill="#141518" stroke="#26272B" stroke-width="1.5"/>
+ <path d="M170 408 H650" stroke="#26272B" stroke-width="1.5"/>
+ <circle cx="198" cy="385" r="4" fill="#2E3036"/>
+ <circle cx="216" cy="385" r="4" fill="#2E3036"/>
+ <circle cx="234" cy="385" r="4" fill="#2E3036"/>
+ <rect x="204" y="434" width="180" height="9" rx="4" fill="#2E3036"/>
+ <rect x="520" y="434" width="61" height="9" rx="4" fill="#43454D"/>
+ <rect x="204" y="468" width="166" height="9" rx="4" fill="#2E3036"/>
+ <rect x="520" y="468" width="62" height="9" rx="4" fill="#43454D"/>
+ <path d="M650 242 H716 Q740 242 740 266 V410 Q740 434 716 434 H650" stroke="#43454D" stroke-width="1.5"/>
+ <circle cx="650" cy="242" r="5" fill="#43454D"/>
+ <circle cx="650" cy="434" r="5" fill="#43454D"/>
+ <rect x="760" y="266" width="270" height="144" rx="16" fill="#141518" stroke="#00B0FF" stroke-width="1.5"/>
+ <rect x="790" y="300" width="120" height="12" rx="6" fill="#00B0FF"/>
+ <rect x="790" y="332" width="196" height="10" rx="5" fill="#2E3036"/>
+ <rect x="790" y="360" width="150" height="10" rx="5" fill="#2E3036"/>
+</svg>
diff --git a/docs/public/changelog/2026-05-26-shelf-life-history.svg b/docs/public/changelog/2026-05-26-shelf-life-history.svg
new file mode 100644
index 0000000000..7a5678014e
--- /dev/null
+++ b/docs/public/changelog/2026-05-26-shelf-life-history.svg
@@ -0,0 +1,24 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 675" fill="none">
+ <rect width="1200" height="675" fill="#09090B"/>
+ <rect x="300" y="196" width="330" height="420" rx="18" fill="#1B1C20" stroke="#26272B" stroke-width="1.5"/>
+ <rect x="360" y="166" width="330" height="420" rx="18" fill="#1B1C20" stroke="#26272B" stroke-width="1.5"/>
+ <rect x="420" y="136" width="330" height="420" rx="18" fill="#141518" stroke="#00B0FF" stroke-width="1.5"/>
+ <rect x="456" y="186" width="150" height="14" rx="7" fill="#00B0FF"/>
+ <path d="M420 220 H750" stroke="#26272B" stroke-width="1.5"/>
+ <rect x="456" y="250" width="223" height="9" rx="4" fill="#2E3036"/>
+ <rect x="456" y="284" width="198" height="9" rx="4" fill="#2E3036"/>
+ <rect x="456" y="318" width="237" height="9" rx="4" fill="#2E3036"/>
+ <rect x="456" y="352" width="189" height="9" rx="4" fill="#2E3036"/>
+ <rect x="456" y="386" width="209" height="9" rx="4" fill="#2E3036"/>
+ <path d="M420 432 H750" stroke="#212329" stroke-width="1.5"/>
+ <circle cx="470" cy="462" r="4" fill="#43454D"/>
+ <rect x="490" y="457" width="164" height="9" rx="4" fill="#212329"/>
+ <circle cx="470" cy="492" r="4" fill="#43454D"/>
+ <rect x="490" y="487" width="173" height="9" rx="4" fill="#212329"/>
+ <rect x="800" y="236" width="250" height="220" rx="14" fill="#1B1C20" stroke="#26272B" stroke-width="1.5"/>
+ <rect x="828" y="270" width="96" height="10" rx="5" fill="#43454D"/>
+ <rect x="828" y="298" width="152" height="8" rx="4" fill="#2E3036"/>
+ <rect x="828" y="334" width="105" height="8" rx="4" fill="#212329"/>
+ <rect x="828" y="364" width="105" height="8" rx="4" fill="#212329"/>
+ <rect x="828" y="394" width="104" height="8" rx="4" fill="#212329"/>
+</svg>
diff --git a/docs/public/changelog/2026-06-09-rework-and-ballooning.svg b/docs/public/changelog/2026-06-09-rework-and-ballooning.svg
new file mode 100644
index 0000000000..6c0c90f3d4
--- /dev/null
+++ b/docs/public/changelog/2026-06-09-rework-and-ballooning.svg
@@ -0,0 +1,30 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 675" fill="none">
+ <rect width="1200" height="675" fill="#09090B"/>
+ <rect x="330" y="152" width="540" height="400" rx="18" fill="#141518" stroke="#26272B" stroke-width="1.5"/>
+ <path d="M330 198 H870" stroke="#26272B" stroke-width="1.5"/>
+ <circle cx="358" cy="175" r="4" fill="#2E3036"/>
+ <circle cx="376" cy="175" r="4" fill="#2E3036"/>
+ <circle cx="394" cy="175" r="4" fill="#2E3036"/>
+ <rect x="404" y="240" width="392" height="240" rx="14" fill="#1B1C20" stroke="#26272B" stroke-width="1.5"/>
+ <circle cx="430" cy="260" r="17" fill="none" stroke="#00B0FF" stroke-width="1.5"/>
+ <circle cx="430" cy="260" r="5" fill="#00B0FF"/>
+ <circle cx="560" cy="214" r="17" fill="none" stroke="#43454D" stroke-width="1.5"/>
+ <circle cx="560" cy="214" r="5" fill="#43454D"/>
+ <circle cx="690" cy="286" r="17" fill="none" stroke="#43454D" stroke-width="1.5"/>
+ <circle cx="690" cy="286" r="5" fill="#43454D"/>
+ <circle cx="612" cy="378" r="17" fill="none" stroke="#43454D" stroke-width="1.5"/>
+ <circle cx="612" cy="378" r="5" fill="#43454D"/>
+ <circle cx="486" cy="392" r="17" fill="none" stroke="#43454D" stroke-width="1.5"/>
+ <circle cx="486" cy="392" r="5" fill="#43454D"/>
+ <rect x="900" y="236" width="160" height="232" rx="14" fill="#1B1C20" stroke="#26272B" stroke-width="1.5"/>
+ <circle cx="926" cy="278" r="4" fill="#00B0FF"/>
+ <rect x="944" y="273" width="65" height="9" rx="4" fill="#2E3036"/>
+ <circle cx="926" cy="312" r="4" fill="#43454D"/>
+ <rect x="944" y="307" width="80" height="9" rx="4" fill="#2E3036"/>
+ <circle cx="926" cy="346" r="4" fill="#43454D"/>
+ <rect x="944" y="341" width="77" height="9" rx="4" fill="#2E3036"/>
+ <circle cx="926" cy="380" r="4" fill="#43454D"/>
+ <rect x="944" y="375" width="85" height="9" rx="4" fill="#2E3036"/>
+ <circle cx="926" cy="414" r="4" fill="#43454D"/>
+ <rect x="944" y="409" width="91" height="9" rx="4" fill="#2E3036"/>
+</svg>
diff --git a/docs/public/changelog/2026-06-23-supersession-and-method-import.svg b/docs/public/changelog/2026-06-23-supersession-and-method-import.svg
new file mode 100644
index 0000000000..066e12304b
--- /dev/null
+++ b/docs/public/changelog/2026-06-23-supersession-and-method-import.svg
@@ -0,0 +1,30 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 675" fill="none">
+ <rect width="1200" height="675" fill="#09090B"/>
+ <rect x="190" y="166" width="470" height="392" rx="16" fill="#141518" stroke="#26272B" stroke-width="1.5"/>
+ <path d="M190 212 H660" stroke="#26272B" stroke-width="1.5"/>
+ <circle cx="218" cy="189" r="4" fill="#2E3036"/>
+ <circle cx="236" cy="189" r="4" fill="#2E3036"/>
+ <circle cx="254" cy="189" r="4" fill="#2E3036"/>
+ <rect x="224" y="242" width="20" height="20" rx="5" fill="#0B3C50" stroke="#00B0FF" stroke-width="1.5"/>
+ <rect x="260" y="246" width="202" height="9" rx="4" fill="#43454D"/>
+ <rect x="548" y="246" width="64" height="9" rx="4" fill="#2E3036"/>
+ <rect x="224" y="300" width="20" height="20" rx="5" fill="#0B3C50" stroke="#00B0FF" stroke-width="1.5"/>
+ <rect x="260" y="304" width="188" height="9" rx="4" fill="#43454D"/>
+ <rect x="548" y="304" width="52" height="9" rx="4" fill="#2E3036"/>
+ <rect x="224" y="358" width="20" height="20" rx="5" fill="none" stroke="#43454D" stroke-width="1.5"/>
+ <rect x="260" y="362" width="149" height="9" rx="4" fill="#2E3036"/>
+ <rect x="548" y="362" width="65" height="9" rx="4" fill="#2E3036"/>
+ <rect x="224" y="416" width="20" height="20" rx="5" fill="none" stroke="#43454D" stroke-width="1.5"/>
+ <rect x="260" y="420" width="202" height="9" rx="4" fill="#2E3036"/>
+ <rect x="548" y="420" width="48" height="9" rx="4" fill="#2E3036"/>
+ <rect x="224" y="474" width="20" height="20" rx="5" fill="none" stroke="#43454D" stroke-width="1.5"/>
+ <rect x="260" y="478" width="174" height="9" rx="4" fill="#2E3036"/>
+ <rect x="548" y="478" width="47" height="9" rx="4" fill="#2E3036"/>
+ <path d="M712 300 H772 M712 420 H772" stroke="#43454D" stroke-width="1.5" stroke-dasharray="5 7"/>
+ <rect x="790" y="246" width="240" height="108" rx="14" fill="#1B1C20" stroke="#26272B" stroke-width="1.5"/>
+ <rect x="818" y="278" width="110" height="10" rx="5" fill="#43454D"/>
+ <rect x="818" y="306" width="164" height="8" rx="4" fill="#2E3036"/>
+ <rect x="790" y="386" width="240" height="108" rx="14" fill="#141518" stroke="#00B0FF" stroke-width="1.5"/>
+ <rect x="818" y="418" width="96" height="12" rx="6" fill="#00B0FF"/>
+ <rect x="818" y="448" width="152" height="8" rx="4" fill="#2E3036"/>
+</svg>
diff --git a/docs/public/changelog/2026-07-07-period-close-and-budgeting.svg b/docs/public/changelog/2026-07-07-period-close-and-budgeting.svg
new file mode 100644
index 0000000000..55eeb86073
--- /dev/null
+++ b/docs/public/changelog/2026-07-07-period-close-and-budgeting.svg
@@ -0,0 +1,53 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 675" fill="none">
+ <rect width="1200" height="675" fill="#09090B"/>
+ <rect x="206" y="178" width="494" height="388" rx="16" fill="#141518" stroke="#26272B" stroke-width="1.5"/>
+ <path d="M206 224 H700" stroke="#26272B" stroke-width="1.5"/>
+ <circle cx="234" cy="201" r="4" fill="#2E3036"/>
+ <circle cx="252" cy="201" r="4" fill="#2E3036"/>
+ <circle cx="270" cy="201" r="4" fill="#2E3036"/>
+ <rect x="250" y="266" width="64" height="44" rx="8" fill="#191C22" stroke="#26272B" stroke-width="1.5"/>
+ <circle cx="282" cy="288" r="4" fill="#43454D"/>
+ <rect x="334" y="266" width="64" height="44" rx="8" fill="#191C22" stroke="#26272B" stroke-width="1.5"/>
+ <circle cx="366" cy="288" r="4" fill="#43454D"/>
+ <rect x="418" y="266" width="64" height="44" rx="8" fill="#191C22" stroke="#26272B" stroke-width="1.5"/>
+ <circle cx="450" cy="288" r="4" fill="#43454D"/>
+ <rect x="502" y="266" width="64" height="44" rx="8" fill="#191C22" stroke="#26272B" stroke-width="1.5"/>
+ <circle cx="534" cy="288" r="4" fill="#43454D"/>
+ <rect x="586" y="266" width="64" height="44" rx="8" fill="#191C22" stroke="#26272B" stroke-width="1.5"/>
+ <circle cx="618" cy="288" r="4" fill="#43454D"/>
+ <rect x="250" y="328" width="64" height="44" rx="8" fill="#191C22" stroke="#26272B" stroke-width="1.5"/>
+ <circle cx="282" cy="350" r="4" fill="#43454D"/>
+ <rect x="334" y="328" width="64" height="44" rx="8" fill="#191C22" stroke="#26272B" stroke-width="1.5"/>
+ <circle cx="366" cy="350" r="4" fill="#43454D"/>
+ <rect x="418" y="328" width="64" height="44" rx="8" fill="#191C22" stroke="#26272B" stroke-width="1.5"/>
+ <circle cx="450" cy="350" r="4" fill="#43454D"/>
+ <rect x="502" y="328" width="64" height="44" rx="8" fill="#191C22" stroke="#26272B" stroke-width="1.5"/>
+ <circle cx="534" cy="350" r="4" fill="#43454D"/>
+ <rect x="586" y="328" width="64" height="44" rx="8" fill="#191C22" stroke="#26272B" stroke-width="1.5"/>
+ <circle cx="618" cy="350" r="4" fill="#43454D"/>
+ <rect x="250" y="390" width="64" height="44" rx="8" fill="#191C22" stroke="#26272B" stroke-width="1.5"/>
+ <circle cx="282" cy="412" r="4" fill="#43454D"/>
+ <rect x="334" y="390" width="64" height="44" rx="8" fill="#191C22" stroke="#26272B" stroke-width="1.5"/>
+ <circle cx="366" cy="412" r="4" fill="#43454D"/>
+ <rect x="418" y="390" width="64" height="44" rx="8" fill="#191C22" stroke="#26272B" stroke-width="1.5"/>
+ <circle cx="450" cy="412" r="4" fill="#43454D"/>
+ <rect x="502" y="390" width="64" height="44" rx="8" fill="#1B1C20" stroke="#26272B" stroke-width="1.5"/>
+ <rect x="524" y="405" width="16" height="16" rx="4" fill="#00B0FF"/>
+ <rect x="586" y="390" width="64" height="44" rx="8" fill="#1B1C20" stroke="#26272B" stroke-width="1.5"/>
+ <rect x="250" y="452" width="64" height="44" rx="8" fill="#1B1C20" stroke="#26272B" stroke-width="1.5"/>
+ <rect x="334" y="452" width="64" height="44" rx="8" fill="#1B1C20" stroke="#26272B" stroke-width="1.5"/>
+ <rect x="418" y="452" width="64" height="44" rx="8" fill="#1B1C20" stroke="#26272B" stroke-width="1.5"/>
+ <rect x="502" y="452" width="64" height="44" rx="8" fill="#1B1C20" stroke="#26272B" stroke-width="1.5"/>
+ <rect x="586" y="452" width="64" height="44" rx="8" fill="#1B1C20" stroke="#26272B" stroke-width="1.5"/>
+ <rect x="750" y="246" width="280" height="252" rx="16" fill="#141518" stroke="#00B0FF" stroke-width="1.5"/>
+ <rect x="780" y="286" width="124" height="12" rx="6" fill="#00B0FF"/>
+ <path d="M750 318 H1030" stroke="#26272B" stroke-width="1.5"/>
+ <circle cx="796" cy="352" r="4" fill="#3FB950"/>
+ <rect x="816" y="347" width="158" height="9" rx="4" fill="#2E3036"/>
+ <circle cx="796" cy="386" r="4" fill="#3FB950"/>
+ <rect x="816" y="381" width="115" height="9" rx="4" fill="#2E3036"/>
+ <circle cx="796" cy="420" r="4" fill="#3FB950"/>
+ <rect x="816" y="415" width="142" height="9" rx="4" fill="#2E3036"/>
+ <circle cx="796" cy="454" r="4" fill="#43454D"/>
+ <rect x="816" y="449" width="142" height="9" rx="4" fill="#2E3036"/>
+</svg>
diff --git a/docs/public/changelog/2026-07-21-inventory-valuation.svg b/docs/public/changelog/2026-07-21-inventory-valuation.svg
new file mode 100644
index 0000000000..60f955b0f9
--- /dev/null
+++ b/docs/public/changelog/2026-07-21-inventory-valuation.svg
@@ -0,0 +1,27 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 675" fill="none">
+ <rect width="1200" height="675" fill="#09090B"/>
+ <rect x="190" y="160" width="820" height="396" rx="16" fill="#141518" stroke="#26272B" stroke-width="1.5"/>
+ <path d="M190 206 H1010" stroke="#26272B" stroke-width="1.5"/>
+ <circle cx="218" cy="183" r="4" fill="#2E3036"/>
+ <circle cx="236" cy="183" r="4" fill="#2E3036"/>
+ <circle cx="254" cy="183" r="4" fill="#2E3036"/>
+ <path d="M600 206 V542" stroke="#26272B" stroke-width="1.5"/>
+ <rect x="228" y="250" width="155" height="9" rx="4" fill="#2E3036"/>
+ <rect x="228" y="296" width="172" height="9" rx="4" fill="#2E3036"/>
+ <rect x="228" y="342" width="153" height="9" rx="4" fill="#2E3036"/>
+ <rect x="228" y="388" width="187" height="9" rx="4" fill="#2E3036"/>
+ <rect x="228" y="434" width="145" height="9" rx="4" fill="#2E3036"/>
+ <rect x="228" y="480" width="153" height="9" rx="4" fill="#2E3036"/>
+ <rect x="636" y="250" width="148" height="9" rx="4" fill="#2E3036"/>
+ <rect x="614" y="248" width="12" height="12" rx="3" fill="#212329"/>
+ <rect x="636" y="296" width="146" height="9" rx="4" fill="#A3423C"/>
+ <rect x="614" y="294" width="12" height="12" rx="3" fill="#A3423C"/>
+ <rect x="636" y="342" width="180" height="9" rx="4" fill="#3FB950"/>
+ <rect x="614" y="340" width="12" height="12" rx="3" fill="#3FB950"/>
+ <rect x="636" y="388" width="198" height="9" rx="4" fill="#2E3036"/>
+ <rect x="614" y="386" width="12" height="12" rx="3" fill="#212329"/>
+ <rect x="636" y="434" width="178" height="9" rx="4" fill="#3FB950"/>
+ <rect x="614" y="432" width="12" height="12" rx="3" fill="#3FB950"/>
+ <rect x="636" y="480" width="183" height="9" rx="4" fill="#2E3036"/>
+ <rect x="614" y="478" width="12" height="12" rx="3" fill="#212329"/>
+</svg>
diff --git a/docs/public/changelog/2026-08-04-stock-movement-corrections.svg b/docs/public/changelog/2026-08-04-stock-movement-corrections.svg
new file mode 100644
index 0000000000..71a1e4f0a8
--- /dev/null
+++ b/docs/public/changelog/2026-08-04-stock-movement-corrections.svg
@@ -0,0 +1,24 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 675" fill="none">
+ <rect width="1200" height="675" fill="#09090B"/>
+ <rect x="230" y="128" width="740" height="420" rx="20" fill="#141518" stroke="#26272B" stroke-width="1.5"/>
+ <path d="M230 174 H970" stroke="#26272B" stroke-width="1.5"/>
+ <circle cx="258" cy="151" r="4" fill="#2E3036"/>
+ <circle cx="276" cy="151" r="4" fill="#2E3036"/>
+ <circle cx="294" cy="151" r="4" fill="#2E3036"/>
+ <rect x="266" y="206" width="20" height="20" rx="5" fill="#212329"/>
+ <rect x="294" y="212" width="96" height="9" rx="4" fill="#43454D"/>
+ <rect x="266" y="242" width="392" height="84" rx="14" fill="#1B1C20" stroke="#26272B" stroke-width="1.5"/>
+ <rect x="294" y="266" width="277" height="10" rx="5" fill="#43454D"/>
+ <rect x="294" y="292" width="177" height="8" rx="4" fill="#2E3036"/>
+ <rect x="266" y="352" width="668" height="76" rx="14" fill="#0B3C50" stroke="#00B0FF" stroke-width="1.5"/>
+ <rect x="294" y="372" width="16" height="16" rx="4" fill="#0F4E66"/>
+ <rect x="318" y="376" width="196" height="11" rx="5" fill="#00B0FF"/>
+ <rect x="318" y="400" width="286" height="9" rx="4" fill="#43454D"/>
+ <circle cx="898" cy="390" r="15" fill="#123322"/>
+ <path d="M891 390 l5 5 10 -11" stroke="#3FB950" stroke-width="2.6" stroke-linecap="round" stroke-linejoin="round" fill="none"/>
+ <rect x="430" y="446" width="504" height="62" rx="14" fill="#1B1C20" stroke="#26272B" stroke-width="1.5"/>
+ <rect x="458" y="468" width="360" height="10" rx="5" fill="#43454D"/>
+ <rect x="458" y="488" width="258" height="8" rx="4" fill="#2E3036"/>
+ <rect x="266" y="528" width="150" height="11" rx="5" fill="#212329"/>
+ <rect x="430" y="528" width="96" height="11" rx="5" fill="#212329"/>
+</svg>
diff --git a/docs/public/changelog/2026-08-18-accounting-sync-engine.svg b/docs/public/changelog/2026-08-18-accounting-sync-engine.svg
new file mode 100644
index 0000000000..801890925f
--- /dev/null
+++ b/docs/public/changelog/2026-08-18-accounting-sync-engine.svg
@@ -0,0 +1,44 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 675" fill="none">
+ <rect width="1200" height="675" fill="#09090B"/>
+ <rect x="160" y="272" width="232" height="104" rx="12" fill="#141518" stroke="#00B0FF" stroke-width="1.5"/>
+ <rect x="180" y="292" width="14" height="14" rx="3" fill="#0B3C50"/>
+ <rect x="202" y="295" width="116" height="9" rx="4" fill="#00B0FF"/>
+ <rect x="180" y="324" width="176" height="8" rx="4" fill="#2E3036"/>
+ <rect x="180" y="342" width="132" height="7" rx="3" fill="#212329"/>
+ <path d="M392 324 H452 Q472 324 472 304 V206 Q472 186 492 186 H556" stroke="#43454D" stroke-width="1.5"/>
+ <path d="M392 324 H556" stroke="#43454D" stroke-width="1.5"/>
+ <path d="M392 324 H452 Q472 324 472 344 V442 Q472 462 492 462 H556" stroke="#43454D" stroke-width="1.5"/>
+ <circle cx="392" cy="324" r="5" fill="#00B0FF"/>
+ <circle cx="556" cy="186" r="3.5" fill="#43454D"/>
+ <circle cx="556" cy="324" r="3.5" fill="#43454D"/>
+ <circle cx="556" cy="462" r="3.5" fill="#43454D"/>
+ <rect x="556" y="134" width="252" height="104" rx="12" fill="#141518" stroke="#26272B" stroke-width="1.5"/>
+ <rect x="576" y="154" width="14" height="14" rx="3" fill="#212329"/>
+ <rect x="598" y="157" width="136" height="9" rx="4" fill="#43454D"/>
+ <rect x="576" y="186" width="196" height="8" rx="4" fill="#2E3036"/>
+ <rect x="576" y="204" width="152" height="7" rx="3" fill="#212329"/>
+ <rect x="556" y="272" width="252" height="104" rx="12" fill="#141518" stroke="#26272B" stroke-width="1.5"/>
+ <rect x="576" y="292" width="14" height="14" rx="3" fill="#212329"/>
+ <rect x="598" y="295" width="136" height="9" rx="4" fill="#43454D"/>
+ <rect x="576" y="324" width="196" height="8" rx="4" fill="#2E3036"/>
+ <rect x="576" y="342" width="152" height="7" rx="3" fill="#212329"/>
+ <rect x="556" y="410" width="252" height="104" rx="12" fill="#141518" stroke="#26272B" stroke-width="1.5"/>
+ <rect x="576" y="430" width="14" height="14" rx="3" fill="#212329"/>
+ <rect x="598" y="433" width="136" height="9" rx="4" fill="#43454D"/>
+ <rect x="576" y="462" width="196" height="8" rx="4" fill="#2E3036"/>
+ <rect x="576" y="480" width="152" height="7" rx="3" fill="#212329"/>
+ <path d="M808 186 H872" stroke="#43454D" stroke-width="1.5"/>
+ <path d="M808 462 H872" stroke="#43454D" stroke-width="1.5"/>
+ <circle cx="872" cy="186" r="3.5" fill="#43454D"/>
+ <circle cx="872" cy="462" r="3.5" fill="#43454D"/>
+ <rect x="872" y="134" width="182" height="104" rx="12" fill="#141518" stroke="#26272B" stroke-width="1.5"/>
+ <rect x="892" y="154" width="14" height="14" rx="3" fill="#212329"/>
+ <rect x="914" y="157" width="66" height="9" rx="4" fill="#43454D"/>
+ <rect x="892" y="186" width="126" height="8" rx="4" fill="#2E3036"/>
+ <rect x="892" y="204" width="82" height="7" rx="3" fill="#212329"/>
+ <rect x="872" y="410" width="182" height="104" rx="12" fill="#141518" stroke="#26272B" stroke-width="1.5"/>
+ <rect x="892" y="430" width="14" height="14" rx="3" fill="#212329"/>
+ <rect x="914" y="433" width="66" height="9" rx="4" fill="#43454D"/>
+ <rect x="892" y="462" width="126" height="8" rx="4" fill="#2E3036"/>
+ <rect x="892" y="480" width="82" height="7" rx="3" fill="#212329"/>
+</svg>
diff --git a/docs/public/changelog/2026-09-04-finite-capacity-scheduling.svg b/docs/public/changelog/2026-09-04-finite-capacity-scheduling.svg
new file mode 100644
index 0000000000..1b419580bb
--- /dev/null
+++ b/docs/public/changelog/2026-09-04-finite-capacity-scheduling.svg
@@ -0,0 +1,43 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 675" fill="none">
+ <rect width="1200" height="675" fill="#09090B"/>
+ <rect x="170" y="146" width="860" height="400" rx="16" fill="#141518" stroke="#26272B" stroke-width="1.5"/>
+ <path d="M170 192 H1030" stroke="#26272B" stroke-width="1.5"/>
+ <circle cx="198" cy="169" r="4" fill="#2E3036"/>
+ <circle cx="216" cy="169" r="4" fill="#2E3036"/>
+ <circle cx="234" cy="169" r="4" fill="#2E3036"/>
+ <rect x="404" y="214" width="22" height="8" rx="4" fill="#43454D"/>
+ <rect x="530" y="214" width="22" height="8" rx="4" fill="#43454D"/>
+ <rect x="656" y="214" width="22" height="8" rx="4" fill="#43454D"/>
+ <rect x="782" y="214" width="22" height="8" rx="4" fill="#43454D"/>
+ <rect x="908" y="214" width="22" height="8" rx="4" fill="#43454D"/>
+ <rect x="1034" y="214" width="22" height="8" rx="4" fill="#43454D"/>
+ <path d="M170 232 H1030" stroke="#212329" stroke-width="1.5"/>
+ <path d="M384 232 V528" stroke="#26272B" stroke-width="1.5"/>
+ <path d="M400 232 V528" stroke="#212329" stroke-width="1.5"/>
+ <path d="M526 232 V528" stroke="#212329" stroke-width="1.5"/>
+ <path d="M652 232 V528" stroke="#212329" stroke-width="1.5"/>
+ <path d="M778 232 V528" stroke="#212329" stroke-width="1.5"/>
+ <path d="M904 232 V528" stroke="#212329" stroke-width="1.5"/>
+ <path d="M1030 232 V528" stroke="#212329" stroke-width="1.5"/>
+ <circle cx="206" cy="268" r="4" fill="#43454D"/>
+ <rect x="224" y="263" width="77" height="9" rx="4" fill="#2E3036"/>
+ <rect x="520" y="258" width="148" height="26" rx="7" fill="#20232A" stroke="#26272B" stroke-width="1.5"/>
+ <circle cx="206" cy="316" r="4" fill="#43454D"/>
+ <rect x="224" y="311" width="83" height="9" rx="4" fill="#2E3036"/>
+ <rect x="603" y="306" width="198" height="26" rx="7" fill="#20232A" stroke="#26272B" stroke-width="1.5"/>
+ <circle cx="206" cy="364" r="4" fill="#00B0FF"/>
+ <rect x="224" y="359" width="74" height="9" rx="4" fill="#43454D"/>
+ <rect x="532" y="354" width="215" height="26" rx="7" fill="#00B0FF" stroke="#00B0FF" stroke-width="1.5"/>
+ <circle cx="206" cy="412" r="4" fill="#43454D"/>
+ <rect x="224" y="407" width="70" height="9" rx="4" fill="#2E3036"/>
+ <rect x="577" y="402" width="208" height="26" rx="7" fill="#20232A" stroke="#26272B" stroke-width="1.5"/>
+ <circle cx="206" cy="460" r="4" fill="#43454D"/>
+ <rect x="224" y="455" width="92" height="9" rx="4" fill="#2E3036"/>
+ <rect x="675" y="450" width="162" height="26" rx="7" fill="#20232A" stroke="#26272B" stroke-width="1.5"/>
+ <circle cx="206" cy="508" r="4" fill="#43454D"/>
+ <rect x="224" y="503" width="62" height="9" rx="4" fill="#2E3036"/>
+ <rect x="695" y="498" width="210" height="26" rx="7" fill="#20232A" stroke="#26272B" stroke-width="1.5"/>
+ <path d="M574 232 V528" stroke="#00B0FF" stroke-width="1.5" stroke-dasharray="4 6"/>
+ <circle cx="574" cy="232" r="5" fill="#00B0FF"/>
+ <path d="M170 522 H1030" stroke="#212329" stroke-width="1.5"/>
+</svg>
diff --git a/docs/public/changelog/2026-09-18-returns-batching-and-the-carbon-api.svg b/docs/public/changelog/2026-09-18-returns-batching-and-the-carbon-api.svg
new file mode 100644
index 0000000000..3cc3a03c37
--- /dev/null
+++ b/docs/public/changelog/2026-09-18-returns-batching-and-the-carbon-api.svg
@@ -0,0 +1,41 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 675" fill="none">
+ <rect width="1200" height="675" fill="#09090B"/>
+ <rect x="200" y="206" width="244" height="78" rx="12" fill="#141518" stroke="#26272B" stroke-width="1.5"/>
+ <rect x="224" y="228" width="12" height="12" rx="3" fill="#D29922"/>
+ <rect x="246" y="230" width="77" height="9" rx="4" fill="#43454D"/>
+ <rect x="224" y="256" width="147" height="8" rx="4" fill="#2E3036"/>
+ <path d="M468 245 H596" stroke="#43454D" stroke-width="1.5" stroke-dasharray="5 7"/>
+ <path d="M587 239 l9 6 -9 6" stroke="#43454D" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" fill="none"/>
+ <rect x="200" y="306" width="244" height="78" rx="12" fill="#141518" stroke="#26272B" stroke-width="1.5"/>
+ <rect x="224" y="328" width="12" height="12" rx="3" fill="#D29922"/>
+ <rect x="246" y="330" width="77" height="9" rx="4" fill="#43454D"/>
+ <rect x="224" y="356" width="145" height="8" rx="4" fill="#2E3036"/>
+ <path d="M468 345 H596" stroke="#43454D" stroke-width="1.5" stroke-dasharray="5 7"/>
+ <path d="M587 339 l9 6 -9 6" stroke="#43454D" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" fill="none"/>
+ <rect x="200" y="406" width="244" height="78" rx="12" fill="#141518" stroke="#26272B" stroke-width="1.5"/>
+ <rect x="224" y="428" width="12" height="12" rx="3" fill="#3FB950"/>
+ <rect x="246" y="430" width="86" height="9" rx="4" fill="#43454D"/>
+ <rect x="224" y="456" width="162" height="8" rx="4" fill="#2E3036"/>
+ <path d="M468 445 H596" stroke="#43454D" stroke-width="1.5" stroke-dasharray="5 7"/>
+ <path d="M587 439 l9 6 -9 6" stroke="#43454D" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" fill="none"/>
+ <rect x="620" y="182" width="344" height="312" rx="16" fill="#141518" stroke="#00B0FF" stroke-width="1.5"/>
+ <path d="M620 228 H964" stroke="#26272B" stroke-width="1.5"/>
+ <circle cx="648" cy="205" r="4" fill="#2E3036"/>
+ <circle cx="666" cy="205" r="4" fill="#2E3036"/>
+ <circle cx="684" cy="205" r="4" fill="#2E3036"/>
+ <rect x="652" y="258" width="60" height="20" rx="8" fill="#0B3C50"/>
+ <rect x="660" y="263" width="44" height="10" rx="5" fill="#00B0FF"/>
+ <rect x="652" y="300" width="224" height="10" rx="5" fill="#2E3036"/>
+ <rect x="652" y="332" width="178" height="10" rx="5" fill="#2E3036"/>
+ <path d="M620 360 HNaN" stroke="#212329" stroke-width="1.5"/>
+ <circle cx="666" cy="392" r="4" fill="#3FB950"/>
+ <rect x="686" y="387" width="168" height="9" rx="4" fill="#2E3036"/>
+ <circle cx="666" cy="424" r="4" fill="#3FB950"/>
+ <rect x="686" y="419" width="191" height="9" rx="4" fill="#2E3036"/>
+ <circle cx="666" cy="456" r="4" fill="#43454D"/>
+ <rect x="686" y="451" width="182" height="9" rx="4" fill="#2E3036"/>
+ <path d="M620 446 H964" stroke="#212329" stroke-width="1.5"/>
+ <circle cx="666" cy="478" r="4" fill="#212329"/>
+ <rect x="686" y="473" width="156" height="9" rx="4" fill="#212329"/>
+ <rect x="652" y="466" width="110" height="18" rx="7" fill="#0B3C50"/>
+</svg>
diff --git a/docs/public/changelog/2026-09-28-ramp-batch-materials-and-community-planning.svg b/docs/public/changelog/2026-09-28-ramp-batch-materials-and-community-planning.svg
new file mode 100644
index 0000000000..f31710f574
--- /dev/null
+++ b/docs/public/changelog/2026-09-28-ramp-batch-materials-and-community-planning.svg
@@ -0,0 +1,42 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 675" fill="none">
+ <rect width="1200" height="675" fill="#09090B"/>
+ <rect x="172" y="268" width="468" height="278" rx="16" fill="#141518" stroke="#26272B" stroke-width="1.5"/>
+ <path d="M172 314 H640" stroke="#26272B" stroke-width="1.5"/>
+ <circle cx="200" cy="291" r="4" fill="#2E3036"/>
+ <circle cx="218" cy="291" r="4" fill="#2E3036"/>
+ <circle cx="236" cy="291" r="4" fill="#2E3036"/>
+ <rect x="206" y="322" width="54" height="8" rx="4" fill="#43454D"/>
+ <rect x="420" y="322" width="44" height="8" rx="4" fill="#43454D"/>
+ <rect x="534" y="322" width="38" height="8" rx="4" fill="#43454D"/>
+ <path d="M172 338 H640" stroke="#212329" stroke-width="1.5"/>
+ <path d="M404 338 V528" stroke="#212329" stroke-width="1.5"/>
+ <path d="M518 338 V528" stroke="#212329" stroke-width="1.5"/>
+ <circle cx="206" cy="349" r="4" fill="#00B0FF"/>
+ <rect x="224" y="344" width="192" height="9" rx="4" fill="#00B0FF"/>
+ <rect x="420" y="344" width="69" height="9" rx="4" fill="#2E3036"/>
+ <rect x="534" y="344" width="42" height="9" rx="4" fill="#43454D"/>
+ <circle cx="206" cy="397" r="4" fill="#3FB950"/>
+ <rect x="224" y="392" width="157" height="9" rx="4" fill="#2E3036"/>
+ <rect x="420" y="392" width="64" height="9" rx="4" fill="#2E3036"/>
+ <rect x="534" y="392" width="47" height="9" rx="4" fill="#2E3036"/>
+ <circle cx="206" cy="445" r="4" fill="#43454D"/>
+ <rect x="224" y="440" width="171" height="9" rx="4" fill="#2E3036"/>
+ <rect x="420" y="440" width="82" height="9" rx="4" fill="#2E3036"/>
+ <rect x="534" y="440" width="57" height="9" rx="4" fill="#2E3036"/>
+ <circle cx="206" cy="493" r="4" fill="#43454D"/>
+ <rect x="224" y="488" width="176" height="9" rx="4" fill="#2E3036"/>
+ <rect x="420" y="488" width="74" height="9" rx="4" fill="#2E3036"/>
+ <rect x="534" y="488" width="54" height="9" rx="4" fill="#2E3036"/>
+ <path d="M172 506 H640" stroke="#212329" stroke-width="1.5"/>
+ <circle cx="206" cy="530" r="4" fill="#212329"/>
+ <rect x="224" y="525" width="132" height="9" rx="4" fill="#212329"/>
+ <rect x="420" y="525" width="56" height="9" rx="4" fill="#212329"/>
+ <rect x="606" y="152" width="404" height="226" rx="20" fill="#1B1C20" stroke="#00B0FF" stroke-width="1.5"/>
+ <rect x="606" y="208" width="404" height="30" fill="#0B3C50"/>
+ <rect x="634" y="172" width="14" height="14" rx="3" fill="#0B3C50"/>
+ <rect x="656" y="175" width="74" height="8" rx="4" fill="#43454D"/>
+ <rect x="634" y="268" width="120" height="12" rx="6" fill="#00B0FF"/>
+ <rect x="634" y="302" width="190" height="10" rx="5" fill="#2E3036"/>
+ <circle cx="954" cy="308" r="17" fill="#22262C"/>
+ <circle cx="922" cy="308" r="17" fill="#0B3C50"/>
+</svg>
diff --git a/docs/scripts/generate-changelog-thumbnail.mjs b/docs/scripts/generate-changelog-thumbnail.mjs
new file mode 100644
index 0000000000..728fe47a36
--- /dev/null
+++ b/docs/scripts/generate-changelog-thumbnail.mjs
@@ -0,0 +1,303 @@
+// Generates a changelog entry's thumbnail from the entry itself.
+//
+// node scripts/generate-changelog-thumbnail.mjs # every entry
+// node scripts/generate-changelog-thumbnail.mjs <slug> # one entry
+//
+// The motif is chosen from the entry's title and tags (MOTIFS below, first match
+// wins), so an illustration describes its own entry rather than being hand-drawn.
+// Layout detail is varied by a hash of the slug, so two entries sharing a motif do
+// not come out identical. Writes public/changelog/<slug>.svg and stamps `image:`
+// into the frontmatter if it is missing.
+//
+// House style, enforced by the changelog-authoring rule: dark, flat, abstract. Solid
+// fills only — no gradients, no shadows, no fill-opacity, no text, no logos. Images
+// render at ~56% in the feed, so detail is lost and only clutter survives.
+
+import { readFileSync, writeFileSync, readdirSync, mkdirSync } from "node:fs";
+import { dirname, resolve, basename } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ENTRIES = resolve(__dirname, "../content/changelog");
+const OUT_DIR = resolve(__dirname, "../public/changelog");
+
+const FIELD = "#09090B", PANEL = "#141518", PANEL2 = "#1B1C20";
+const STROKE = "#26272B", FAINT = "#212329", DIM = "#2E3036", MID = "#43454D";
+const ACCENT = "#00B0FF", ACC_BG = "#0B3C50";
+const GREEN = "#3FB950", AMBER = "#D29922", RED = "#A3423C";
+
+/* ── primitives ─────────────────────────────────────────────────────────── */
+const panel = (x, y, w, h, r = 16, fill = PANEL, stroke = STROKE) =>
+ ` <rect x="${x}" y="${y}" width="${w}" height="${h}" rx="${r}" fill="${fill}" stroke="${stroke}" stroke-width="1.5"/>`;
+const bar = (x, y, w, fill = DIM, h = 10, r = 5) =>
+ ` <rect x="${x}" y="${y}" width="${w}" height="${h}" rx="${r}" fill="${fill}"/>`;
+const dot = (cx, cy, r, fill) => ` <circle cx="${cx}" cy="${cy}" r="${r}" fill="${fill}"/>`;
+const ring = (cx, cy, r, stroke) =>
+ ` <circle cx="${cx}" cy="${cy}" r="${r}" fill="none" stroke="${stroke}" stroke-width="1.5"/>`;
+const sq = (x, y, s, fill, r = 3) =>
+ ` <rect x="${x}" y="${y}" width="${s}" height="${s}" rx="${r}" fill="${fill}"/>`;
+const hr = (x, y, w, c = FAINT) => ` <path d="M${x} ${y} H${x + w}" stroke="${c}" stroke-width="1.5"/>`;
+const vr = (x, y, h, c = FAINT) => ` <path d="M${x} ${y} V${y + h}" stroke="${c}" stroke-width="1.5"/>`;
+const chrome = (x, y, w) =>
+ [hr(x, y + 46, w, STROKE), ...[0, 1, 2].map((i) => dot(x + 28 + i * 18, y + 23, 4, DIM))].join("\n");
+const arrow = (x1, x2, y) =>
+ ` <path d="M${x1} ${y} H${x2}" stroke="${MID}" stroke-width="1.5" stroke-dasharray="5 7"/>\n` +
+ ` <path d="M${x2 - 9} ${y - 6} l9 6 -9 6" stroke="${MID}" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" fill="none"/>`;
+
+/** Deterministic pseudo-random from the slug, so a rebuild is byte-identical. */
+function seeded(slug) {
+ let h = 2166136261;
+ for (const ch of slug) { h ^= ch.charCodeAt(0); h = Math.imul(h, 16777619); }
+ return (n) => { h = Math.imul(h ^ (h >>> 15), 2246822507); return Math.abs(h) % n; };
+}
+const pick = (rnd, lo, hi) => lo + rnd(hi - lo + 1);
+
+/* ── motifs ─────────────────────────────────────────────────────────────── */
+const M = {
+ ledger: (r) => {
+ const rows = [0, 1, 2, 3].map((i) =>
+ [dot(206, 349 + i * 48, 4, i === 0 ? ACCENT : i === 1 ? GREEN : MID),
+ bar(224, 344 + i * 48, pick(r, 130, 200), i === 0 ? ACCENT : DIM, 9, 4),
+ bar(420, 344 + i * 48, pick(r, 60, 90), DIM, 9, 4),
+ bar(534, 344 + i * 48, pick(r, 42, 60), i === 0 ? MID : DIM, 9, 4)].join("\n"));
+ return [panel(172, 268, 468, 278), chrome(172, 268, 468),
+ bar(206, 322, 54, MID, 8, 4), bar(420, 322, 44, MID, 8, 4), bar(534, 322, 38, MID, 8, 4),
+ hr(172, 338, 468), vr(404, 338, 190), vr(518, 338, 190), ...rows, hr(172, 506, 468),
+ dot(206, 530, 4, FAINT), bar(224, 525, 132, FAINT, 9, 4), bar(420, 525, 56, FAINT, 9, 4),
+ panel(606, 152, 404, 226, 20, PANEL2, ACCENT),
+ ` <rect x="606" y="208" width="404" height="30" fill="${ACC_BG}"/>`,
+ sq(634, 172, 14, ACC_BG), bar(656, 175, 74, MID, 8, 4),
+ bar(634, 268, 120, ACCENT, 12, 6), bar(634, 302, 190, DIM),
+ dot(954, 308, 17, "#22262C"), dot(922, 308, 17, ACC_BG)].join("\n");
+ },
+
+ gantt: (r) => {
+ const lanes = [0, 1, 2, 3, 4, 5].map((i) => {
+ const hot = i === 2, x = pick(r, 40, 330), w = pick(r, 130, 250);
+ return [dot(206, 268 + i * 48, 4, hot ? ACCENT : MID),
+ bar(224, 263 + i * 48, pick(r, 62, 92), hot ? MID : DIM, 9, 4),
+ ` <rect x="${400 + x}" y="${258 + i * 48}" width="${w}" height="26" rx="7" fill="${hot ? ACCENT : "#20232A"}" stroke="${hot ? ACCENT : STROKE}" stroke-width="1.5"/>`].join("\n");
+ });
+ return [panel(170, 146, 860, 400), chrome(170, 146, 860),
+ ...[0,1,2,3,4,5].map((i) => bar(404 + i * 126, 214, 22, MID, 8, 4)),
+ hr(170, 232, 860), vr(384, 232, 296, STROKE),
+ ...[0,1,2,3,4,5].map((i) => vr(400 + i * 126, 232, 296)), ...lanes,
+ ` <path d="M574 232 V528" stroke="${ACCENT}" stroke-width="1.5" stroke-dasharray="4 6"/>`,
+ dot(574, 232, 5, ACCENT), hr(170, 522, 860)].join("\n");
+ },
+
+ merge: (r) => {
+ const jobs = [0, 1, 2].map((i) => {
+ const y = 206 + i * 100;
+ return [panel(200, y, 244, 78, 12), sq(224, y + 22, 12, i === 2 ? GREEN : AMBER),
+ bar(246, y + 24, pick(r, 74, 100), MID, 9, 4), bar(224, y + 50, pick(r, 140, 180), DIM, 8, 4),
+ arrow(468, 596, y + 39)].join("\n");
+ });
+ return [...jobs, panel(620, 182, 344, 312, 16, PANEL, ACCENT), chrome(620, 182, 344),
+ bar(652, 258, 60, ACC_BG, 20, 8), bar(660, 263, 44, ACCENT, 10, 5),
+ bar(652, 300, 224, DIM), bar(652, 332, 178, DIM), hr(620, 360),
+ ...[0,1,2].map((i) => [dot(666, 392 + i * 32, 4, i < 2 ? GREEN : MID),
+ bar(686, 387 + i * 32, pick(r, 140, 200), DIM, 9, 4)].join("\n")),
+ hr(620, 446, 344), dot(666, 478, 4, FAINT), bar(686, 473, 156, FAINT, 9, 4),
+ bar(652, 466, 110, ACC_BG, 18, 7)].join("\n");
+ },
+
+ flow: (r) => {
+ const node = (x, y, w, h, accent = false) =>
+ [panel(x, y, w, h, 12, PANEL, accent ? ACCENT : STROKE),
+ sq(x + 20, y + 20, 14, accent ? ACC_BG : FAINT),
+ bar(x + 42, y + 23, w - 116, accent ? ACCENT : MID, 9, 4),
+ bar(x + 20, y + 52, w - 56, DIM, 8, 4),
+ bar(x + 20, y + 70, w - 100, FAINT, 7, 3)].join("\n");
+ return [node(160, 272, 232, 104, true),
+ ` <path d="M392 324 H452 Q472 324 472 304 V206 Q472 186 492 186 H556" stroke="${MID}" stroke-width="1.5"/>`,
+ ` <path d="M392 324 H556" stroke="${MID}" stroke-width="1.5"/>`,
+ ` <path d="M392 324 H452 Q472 324 472 344 V442 Q472 462 492 462 H556" stroke="${MID}" stroke-width="1.5"/>`,
+ dot(392, 324, 5, ACCENT), ...[186, 324, 462].map((y) => dot(556, y, 3.5, MID)),
+ node(556, 134, 252, 104), node(556, 272, 252, 104), node(556, 410, 252, 104),
+ ` <path d="M808 186 H872" stroke="${MID}" stroke-width="1.5"/>`,
+ ` <path d="M808 462 H872" stroke="${MID}" stroke-width="1.5"/>`,
+ ...[186, 462].map((y) => dot(872, y, 3.5, MID)),
+ node(872, 134, 182, 104), node(872, 410, 182, 104)].join("\n");
+ },
+
+ conversation: (r) => [panel(230, 128, 740, 420, 20), chrome(230, 128, 740),
+ sq(266, 206, 20, FAINT, 5), bar(294, 212, 96, MID, 9, 4),
+ panel(266, 242, 392, 84, 14, PANEL2, STROKE),
+ bar(294, 266, pick(r, 230, 280), MID), bar(294, 292, pick(r, 160, 200), DIM, 8, 4),
+ ` <rect x="266" y="352" width="668" height="76" rx="14" fill="${ACC_BG}" stroke="${ACCENT}" stroke-width="1.5"/>`,
+ sq(294, 372, 16, "#0F4E66", 4), bar(318, 376, 196, ACCENT, 11, 5), bar(318, 400, 286, MID, 9, 4),
+ dot(898, 390, 15, "#123322"),
+ ` <path d="M891 390 l5 5 10 -11" stroke="${GREEN}" stroke-width="2.6" stroke-linecap="round" stroke-linejoin="round" fill="none"/>`,
+ panel(430, 446, 504, 62, 14, PANEL2, STROKE), bar(458, 468, 360, MID), bar(458, 488, 258, DIM, 8, 4),
+ bar(266, 528, 150, FAINT, 11, 5), bar(430, 528, 96, FAINT, 11, 5)].join("\n"),
+
+ diff: (r) => {
+ const kinds = ["same", "del", "add", "same", "add", "same"];
+ return [panel(190, 160, 820, 396), chrome(190, 160, 820), vr(600, 206, 336, STROKE),
+ ...kinds.map((_, i) => bar(228, 250 + i * 46, pick(r, 145, 215), DIM, 9, 4)),
+ ...kinds.map((k, i) => {
+ const c = k === "add" ? GREEN : k === "del" ? RED : DIM;
+ return [` <rect x="636" y="${250 + i * 46}" width="${pick(r, 140, 205)}" height="9" rx="4" fill="${c}"/>`,
+ sq(614, 248 + i * 46, 12, k === "same" ? FAINT : c, 3)].join("\n");
+ })].join("\n");
+ },
+
+ calendar: (r) => {
+ const cells = [];
+ for (let row = 0; row < 4; row++) for (let c = 0; c < 5; c++) {
+ const x = 250 + c * 84, y = 266 + row * 62;
+ const closed = row < 2 || (row === 2 && c < 3);
+ cells.push(` <rect x="${x}" y="${y}" width="64" height="44" rx="8" fill="${closed ? "#191C22" : PANEL2}" stroke="${STROKE}" stroke-width="1.5"/>`);
+ if (row === 2 && c === 3) cells.push(sq(x + 22, y + 15, 16, ACCENT, 4));
+ else if (closed) cells.push(dot(x + 32, y + 22, 4, MID));
+ }
+ return [panel(206, 178, 494, 388), chrome(206, 178, 494), ...cells,
+ panel(750, 246, 280, 252, 16, PANEL, ACCENT),
+ bar(780, 286, 124, ACCENT, 12, 6), hr(750, 318, 280, STROKE),
+ ...[0,1,2,3].map((i) => [dot(796, 352 + i * 34, 4, i < 3 ? GREEN : MID),
+ bar(816, 347 + i * 34, pick(r, 115, 165), DIM, 9, 4)].join("\n"))].join("\n");
+ },
+
+ checklist: (r) => [panel(190, 166, 470, 392), chrome(190, 166, 470),
+ ...[0,1,2,3,4].map((i) => [
+ ` <rect x="224" y="${242 + i * 58}" width="20" height="20" rx="5" fill="${i < 2 ? ACC_BG : "none"}" stroke="${i < 2 ? ACCENT : MID}" stroke-width="1.5"/>`,
+ bar(260, 246 + i * 58, pick(r, 140, 220), i < 2 ? MID : DIM, 9, 4),
+ bar(548, 246 + i * 58, pick(r, 46, 72), DIM, 9, 4)].join("\n")),
+ ` <path d="M712 300 H772 M712 420 H772" stroke="${MID}" stroke-width="1.5" stroke-dasharray="5 7"/>`,
+ panel(790, 246, 240, 108, 14, PANEL2, STROKE), bar(818, 278, 110, MID), bar(818, 306, 164, DIM, 8, 4),
+ panel(790, 386, 240, 108, 14, PANEL, ACCENT), bar(818, 418, 96, ACCENT, 12, 6), bar(818, 448, 152, DIM, 8, 4)].join("\n"),
+
+ balloons: (r) => {
+ const pts = [[430, 260], [560, 214], [690, 286], [612, 378], [486, 392]];
+ return [panel(330, 152, 540, 400, 18), chrome(330, 152, 540),
+ ` <rect x="404" y="240" width="392" height="240" rx="14" fill="${PANEL2}" stroke="${STROKE}" stroke-width="1.5"/>`,
+ ...pts.flatMap(([cx, cy], i) => [ring(cx, cy, 17, i === 0 ? ACCENT : MID), dot(cx, cy, 5, i === 0 ? ACCENT : MID)]),
+ panel(900, 236, 160, 232, 14, PANEL2, STROKE),
+ ...[0,1,2,3,4].map((i) => [dot(926, 278 + i * 34, 4, i === 0 ? ACCENT : MID),
+ bar(944, 273 + i * 34, pick(r, 58, 92), DIM, 9, 4)].join("\n"))].join("\n");
+ },
+
+ stack: (r) => [panel(300, 196, 330, 420, 18, PANEL2, STROKE), panel(360, 166, 330, 420, 18, PANEL2, STROKE),
+ panel(420, 136, 330, 420, 18, PANEL, ACCENT), bar(456, 186, 150, ACCENT, 14, 7), hr(420, 220, 330, STROKE),
+ ...[0,1,2,3,4].map((i) => bar(456, 250 + i * 34, pick(r, 160, 240), DIM, 9, 4)),
+ hr(420, 432, 330), ...[0,1].map((i) => [dot(470, 462 + i * 30, 4, MID), bar(490, 457 + i * 30, pick(r, 130, 175), FAINT, 9, 4)].join("\n")),
+ panel(800, 236, 250, 220, 14, PANEL2, STROKE), bar(828, 270, 96, MID), bar(828, 298, 152, DIM, 8, 4),
+ ...[0,1,2].map((i) => bar(828, 334 + i * 30, pick(r, 96, 140), FAINT, 8, 4))].join("\n"),
+
+ branch: (r) => [panel(170, 152, 480, 180, 16), chrome(170, 152, 480),
+ ...[0,1].map((i) => [bar(204, 224 + i * 34, pick(r, 128, 175), DIM, 9, 4), bar(520, 224 + i * 34, pick(r, 54, 78), MID, 9, 4)].join("\n")),
+ panel(170, 362, 480, 180, 16), chrome(170, 362, 480),
+ ...[0,1].map((i) => [bar(204, 434 + i * 34, pick(r, 140, 185), DIM, 9, 4), bar(520, 434 + i * 34, pick(r, 60, 84), MID, 9, 4)].join("\n")),
+ ` <path d="M650 242 H716 Q740 242 740 266 V410 Q740 434 716 434 H650" stroke="${MID}" stroke-width="1.5"/>`,
+ dot(650, 242, 5, MID), dot(650, 434, 5, MID),
+ panel(760, 266, 270, 144, 16, PANEL, ACCENT),
+ bar(790, 300, 120, ACCENT, 12, 6), bar(790, 332, 196, DIM), bar(790, 360, 150, DIM)].join("\n"),
+
+ grid: (r) => {
+ const cells = [];
+ for (let row = 0; row < 3; row++) for (let c = 0; c < 4; c++) {
+ const x = 250 + c * 168, y = 232 + row * 104, hot = row === 1 && c === 1;
+ cells.push([panel(x, y, 144, 80, 12, PANEL2, hot ? ACCENT : STROKE),
+ bar(x + 20, y + 22, pick(r, 56, 88), hot ? ACCENT : MID, 9, 4),
+ bar(x + 20, y + 46, pick(r, 86, 112), hot ? ACC_BG : FAINT, 8, 4)].join("\n"));
+ }
+ return [panel(206, 168, 788, 388), chrome(206, 168, 788), ...cells].join("\n");
+ },
+
+ rings: (r) => [panel(390, 158, 420, 360, 20), chrome(390, 158, 420),
+ ...[34, 62, 90].map((rad) => ring(600, 300, rad, rad === 34 ? ACCENT : STROKE)),
+ dot(600, 300, 10, ACCENT), bar(444, 404, 312, DIM), bar(444, 436, 236, DIM),
+ ` <rect x="444" y="470" width="312" height="30" rx="8" fill="${ACC_BG}"/>`, bar(460, 478, 120, ACCENT, 14, 7),
+ panel(160, 236, 190, 204, 14, PANEL2, STROKE), bar(186, 270, 94, MID), bar(186, 298, 130, DIM, 8, 4),
+ ...[0,1,2].map((i) => bar(186, 334 + i * 28, pick(r, 86, 126), FAINT, 8, 4)),
+ panel(850, 236, 190, 204, 14, PANEL2, STROKE), bar(876, 270, 82, MID), bar(876, 298, 126, DIM, 8, 4),
+ ...[0,1,2].map((i) => bar(876, 334 + i * 28, pick(r, 90, 124), FAINT, 8, 4))].join("\n"),
+
+ dashboard: (r) => [panel(150, 180, 470, 316), chrome(150, 180, 470),
+ bar(184, 268, 150, ACCENT, 16, 8), bar(184, 306, 224, DIM), bar(184, 338, 178, DIM), hr(150, 374, 470),
+ ...[0,1,2].map((i) => [dot(198, 410 + i * 30, 4, i < 2 ? GREEN : AMBER),
+ bar(218, 405 + i * 30, pick(r, 140, 200), DIM, 9, 4)].join("\n")),
+ panel(660, 180, 392, 316),
+ ...[0,1,2].flatMap((row) => [panel(688, 214 + row * 100, 168, 80, 12, PANEL2, STROKE),
+ panel(872, 214 + row * 100, 152, 80, 12, PANEL2, STROKE),
+ bar(708, 238 + row * 100, pick(r, 48, 76), row === 0 ? ACCENT : MID, 14, 7),
+ bar(708, 264 + row * 100, pick(r, 90, 112), DIM, 8, 4),
+ bar(892, 238 + row * 100, pick(r, 46, 62), MID, 14, 7),
+ bar(892, 264 + row * 100, pick(r, 82, 100), DIM, 8, 4)])].join("\n"),
+};
+
+/* A motif is chosen by WHERE its keywords appear in the title, not by a fixed
+ * priority order: changelog titles lead with the headline feature, so the earliest
+ * match is the entry's real subject. "Ramp card transactions, batch materials, …"
+ * is a ledger entry, not a batching one. Tags are a fallback only. */
+const MOTIFS = [
+ ["dashboard", /dashboard|time clock|timecard|report/i],
+ ["gantt", /schedul|capacity|gantt/i],
+ ["merge", /batching|batch |merge|consolidat/i],
+ ["flow", /workflow|automation|trigger/i],
+ ["conversation", /agent|assistant|chat/i],
+ ["diff", /change notice|revision|diff|supersession|engineering change/i],
+ ["calendar", /period clos|closing|month-end|backup/i],
+ ["checklist", /picking|pick list|inspection|label|inventory count|checklist/i],
+ ["stack", /document|pdf|asset|template/i],
+ ["branch", /multi-entity|intercompany|storage rule/i],
+ ["grid", /storage unit|inventory|bin|shelf|warehouse/i],
+ ["rings", /passkey|sign-in|sso|two-factor|mcp|console|api\b|security/i],
+ ["ledger", /accounting|ledger|invoice|payment|card transaction|journal|budget|valuation/i],
+ ["balloons", /balloon/i],
+];
+
+/** Earliest keyword position in the title wins; tags only break a total miss. */
+export function motifFor(title, tags = []) {
+ let best = null;
+ for (const [name, re] of MOTIFS) {
+ const at = title.search(re);
+ if (at !== -1 && (best === null || at < best.at)) best = { name, at };
+ }
+ if (best) return best.name;
+ const hay = tags.join(" ");
+ for (const [name, re] of MOTIFS) if (re.test(hay)) return name;
+ return "grid";
+}
+
+export function renderThumbnail({ slug, title, tags }) {
+ const motif = motifFor(title, tags);
+ const body = M[motif](seeded(slug));
+ return {
+ motif,
+ svg: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 675" fill="none">\n` +
+ ` <rect width="1200" height="675" fill="${FIELD}"/>\n${body}\n</svg>\n`,
+ };
+}
+
+/* ── CLI ────────────────────────────────────────────────────────────────── */
+function frontmatter(raw) {
+ const block = raw.split("---")[1] ?? "";
+ const get = (k) => (block.match(new RegExp(`^${k}:\\s*(.*)$`, "m"))?.[1] ?? "").trim();
+ const strip = (v) => v.replace(/^["']|["']$/g, "");
+ return {
+ title: strip(get("title")),
+ tags: (get("tags").match(/"[^"]*"/g) ?? []).map((t) => t.slice(1, -1)),
+ hasImage: /^image:/m.test(block),
+ };
+}
+
+const only = process.argv[2];
+mkdirSync(OUT_DIR, { recursive: true });
+let n = 0;
+for (const file of readdirSync(ENTRIES).filter((f) => f.endsWith(".mdx")).sort()) {
+ const slug = basename(file, ".mdx");
+ if (only && slug !== only) continue;
+ const path = resolve(ENTRIES, file);
+ const raw = readFileSync(path, "utf8");
+ const { title, tags, hasImage } = frontmatter(raw);
+ const { motif, svg } = renderThumbnail({ slug, title, tags });
+ writeFileSync(resolve(OUT_DIR, `${slug}.svg`), svg);
+ if (!hasImage) {
+ writeFileSync(path, raw.replace(/^(tags:.*)$/m, `$1\nimage: "/changelog/${slug}.svg"`));
+ }
+ console.log(`${motif.padEnd(13)} ${slug}`);
+ n++;
+}
+if (n === 0) { console.error(only ? `no entry "${only}"` : "no entries"); process.exit(1); }
diff --git a/docs/source.config.ts b/docs/source.config.ts
index f8631849e7..372e4167a6 100644
--- a/docs/source.config.ts
+++ b/docs/source.config.ts
@@ -31,6 +31,19 @@ export const guide = defineDocs({
},
});
+// One file per dated entry. Carbon has no versions, so `date` is the ordering key.
+export const changelog = defineDocs({
+ dir: "content/changelog",
+ docs: {
+ schema: pageSchema.extend({
+ date: z.string().date(),
+ tags: z.array(z.string()).default([]),
+ // Optional hero image, a path under /public.
+ image: z.string().optional(),
+ }),
+ },
+});
+
// Remove <AgentContext> blocks from the MDX AST before fumadocs' remark-structure
// runs. AgentContext is agent-only: this keeps its content out of the rendered page
// AND out of the site search index (structuredData). The in-app agent still receives
diff --git a/packages/database/src/authz/manifest.ts b/packages/database/src/authz/manifest.ts
index 20bc3d6905..7289fc79b8 100644
--- a/packages/database/src/authz/manifest.ts
+++ b/packages/database/src/authz/manifest.ts
@@ -232,6 +232,7 @@ export const manifest = {
changeOrderRequiredAction: company("parts"),
changeOrderSupersession: company("parts", { read: "parts_view" }),
changeOrderType: company("parts"),
+ changelogDispatch: serviceOnly(),
company: policies({
select: and(
isNotNull("companyGroupId"),
diff --git a/packages/database/src/swagger-docs-schema.ts b/packages/database/src/swagger-docs-schema.ts
index 3a741109db..d35f2c3bdf 100644
--- a/packages/database/src/swagger-docs-schema.ts
+++ b/packages/database/src/swagger-docs-schema.ts
@@ -6402,6 +6402,141 @@ export default {
tags: ["workflow"]
}
},
+ "/changelogDispatch": {
+ get: {
+ parameters: [
+ {
+ $ref: "#/parameters/rowFilter.changelogDispatch.guid"
+ },
+ {
+ $ref: "#/parameters/rowFilter.changelogDispatch.title"
+ },
+ {
+ $ref: "#/parameters/rowFilter.changelogDispatch.description"
+ },
+ {
+ $ref: "#/parameters/rowFilter.changelogDispatch.dispatchedAt"
+ },
+ {
+ $ref: "#/parameters/rowFilter.changelogDispatch.emailsSent"
+ },
+ {
+ $ref: "#/parameters/select"
+ },
+ {
+ $ref: "#/parameters/order"
+ },
+ {
+ $ref: "#/parameters/range"
+ },
+ {
+ $ref: "#/parameters/rangeUnit"
+ },
+ {
+ $ref: "#/parameters/offset"
+ },
+ {
+ $ref: "#/parameters/limit"
+ },
+ {
+ $ref: "#/parameters/preferCount"
+ }
+ ],
+ responses: {
+ "200": {
+ description: "OK",
+ schema: {
+ items: {
+ $ref: "#/definitions/changelogDispatch"
+ },
+ type: "array"
+ }
+ },
+ "206": {
+ description: "Partial Content"
+ }
+ },
+ tags: ["changelogDispatch"]
+ },
+ post: {
+ parameters: [
+ {
+ $ref: "#/parameters/body.changelogDispatch"
+ },
+ {
+ $ref: "#/parameters/select"
+ },
+ {
+ $ref: "#/parameters/preferPost"
+ }
+ ],
+ responses: {
+ "201": {
+ description: "Created"
+ }
+ },
+ tags: ["changelogDispatch"]
+ },
+ delete: {
+ parameters: [
+ {
+ $ref: "#/parameters/rowFilter.changelogDispatch.guid"
+ },
+ {
+ $ref: "#/parameters/rowFilter.changelogDispatch.title"
+ },
+ {
+ $ref: "#/parameters/rowFilter.changelogDispatch.description"
+ },
+ {
+ $ref: "#/parameters/rowFilter.changelogDispatch.dispatchedAt"
+ },
+ {
+ $ref: "#/parameters/rowFilter.changelogDispatch.emailsSent"
+ },
+ {
+ $ref: "#/parameters/preferReturn"
+ }
+ ],
+ responses: {
+ "204": {
+ description: "No Content"
+ }
+ },
+ tags: ["changelogDispatch"]
+ },
+ patch: {
+ parameters: [
+ {
+ $ref: "#/parameters/rowFilter.changelogDispatch.guid"
+ },
+ {
+ $ref: "#/parameters/rowFilter.changelogDispatch.title"
+ },
+ {
+ $ref: "#/parameters/rowFilter.changelogDispatch.description"
+ },
+ {
+ $ref: "#/parameters/rowFilter.changelogDispatch.dispatchedAt"
+ },
+ {
+ $ref: "#/parameters/rowFilter.changelogDispatch.emailsSent"
+ },
+ {
+ $ref: "#/parameters/body.changelogDispatch"
+ },
+ {
+ $ref: "#/parameters/preferReturn"
+ }
+ ],
+ responses: {
+ "204": {
+ description: "No Content"
+ }
+ },
+ tags: ["changelogDispatch"]
+ }
+ },
"/approvalRequests": {
get: {
parameters: [
@@ -109391,6 +109526,35 @@ export default {
},
type: "object"
},
+ changelogDispatch: {
+ required: ["guid", "dispatchedAt", "emailsSent"],
+ properties: {
+ guid: {
+ description: "Note:\nThis is a Primary Key.<pk/>",
+ format: "text",
+ type: "string"
+ },
+ title: {
+ format: "text",
+ type: "string"
+ },
+ description: {
+ format: "text",
+ type: "string"
+ },
+ dispatchedAt: {
+ default: "now()",
+ format: "timestamp with time zone",
+ type: "string"
+ },
+ emailsSent: {
+ default: 0,
+ format: "integer",
+ type: "integer"
+ }
+ },
+ type: "object"
+ },
approvalRequests: {
properties: {
id: {
@@ -154498,6 +154662,45 @@ export default {
in: "query",
type: "string"
},
+ "body.changelogDispatch": {
+ name: "changelogDispatch",
+ description: "changelogDispatch",
+ required: false,
+ in: "body",
+ schema: {
+ $ref: "#/definitions/changelogDispatch"
+ }
+ },
+ "rowFilter.changelogDispatch.guid": {
+ name: "guid",
+ required: false,
+ in: "query",
+ type: "string"
+ },
+ "rowFilter.changelogDispatch.title": {
+ name: "title",
+ required: false,
+ in: "query",
+ type: "string"
+ },
+ "rowFilter.changelogDispatch.description": {
+ name: "description",
+ required: false,
+ in: "query",
+ type: "string"
+ },
+ "rowFilter.changelogDispatch.dispatchedAt": {
+ name: "dispatchedAt",
+ required: false,
+ in: "query",
+ type: "string"
+ },
+ "rowFilter.changelogDispatch.emailsSent": {
+ name: "emailsSent",
+ required: false,
+ in: "query",
+ type: "string"
+ },
"body.approvalRequests": {
name: "approvalRequests",
description: "approvalRequests",
diff --git a/packages/database/src/types.ts b/packages/database/src/types.ts
index b84dc53ab5..5971f6bbcb 100644
--- a/packages/database/src/types.ts
+++ b/packages/database/src/types.ts
@@ -5478,6 +5478,30 @@ export type Database = {
}
]
}
+ changelogDispatch: {
+ Row: {
+ description: string | null
+ dispatchedAt: string
+ emailsSent: number
+ guid: string
+ title: string | null
+ }
+ Insert: {
+ description?: string | null
+ dispatchedAt?: string
+ emailsSent?: number
+ guid: string
+ title?: string | null
+ }
+ Update: {
+ description?: string | null
+ dispatchedAt?: string
+ emailsSent?: number
+ guid?: string
+ title?: string | null
+ }
+ Relationships: []
+ }
changeOrder: {
Row: {
approvalRequirements: string[] | null
diff --git a/packages/database/supabase/functions/lib/types.ts b/packages/database/supabase/functions/lib/types.ts
index b84dc53ab5..5971f6bbcb 100644
--- a/packages/database/supabase/functions/lib/types.ts
+++ b/packages/database/supabase/functions/lib/types.ts
@@ -5478,6 +5478,30 @@ export type Database = {
}
]
}
+ changelogDispatch: {
+ Row: {
+ description: string | null
+ dispatchedAt: string
+ emailsSent: number
+ guid: string
+ title: string | null
+ }
+ Insert: {
+ description?: string | null
+ dispatchedAt?: string
+ emailsSent?: number
+ guid: string
+ title?: string | null
+ }
+ Update: {
+ description?: string | null
+ dispatchedAt?: string
+ emailsSent?: number
+ guid?: string
+ title?: string | null
+ }
+ Relationships: []
+ }
changeOrder: {
Row: {
approvalRequirements: string[] | null
diff --git a/packages/database/supabase/migrations/20260929190436_changelog-dispatch.sql b/packages/database/supabase/migrations/20260929190436_changelog-dispatch.sql
new file mode 100644
index 0000000000..509dc91b82
--- /dev/null
+++ b/packages/database/supabase/migrations/20260929190436_changelog-dispatch.sql
@@ -0,0 +1,13 @@
+-- Changelog newsletter dispatch ledger: one row per feed entry already handled.
+-- Platform-level, so no companyId. Service-role only: RLS comes from the authz
+-- manifest (`changelogDispatch: serviceOnly()`).
+-- IF NOT EXISTS because this replaces 20260904191748_changelog-subscriptions.sql,
+-- which some development databases already ran.
+CREATE TABLE IF NOT EXISTS "changelogDispatch" (
+ "guid" TEXT NOT NULL,
+ "title" TEXT,
+ "description" TEXT,
+ "dispatchedAt" TIMESTAMP WITH TIME ZONE NOT NULL DEFAULT NOW(),
+ "emailsSent" INTEGER NOT NULL DEFAULT 0,
+ CONSTRAINT "changelogDispatch_pkey" PRIMARY KEY ("guid")
+);
diff --git a/packages/database/supabase/migrations/20260929190629_changelog-dispatch-authz.sql b/packages/database/supabase/migrations/20260929190629_changelog-dispatch-authz.sql
new file mode 100644
index 0000000000..3b5d3b47bd
--- /dev/null
+++ b/packages/database/supabase/migrations/20260929190629_changelog-dispatch-authz.sql
@@ -0,0 +1,14 @@
+-- Generated by `pnpm --filter @carbon/database authz migration` from packages/database/src/authz. Do not edit.
+
+-- Ships these rules to databases where `authz sync` does not run after migrations yet.
+
+-- changelogDispatch
+DO $authz$
+DECLARE p record;
+BEGIN
+ FOR p IN SELECT policyname FROM pg_policies WHERE schemaname = 'public' AND tablename = 'changelogDispatch' LOOP
+ EXECUTE format('DROP POLICY %I ON public.%I', p.policyname, 'changelogDispatch');
+ END LOOP;
+END
+$authz$;
+ALTER TABLE public."changelogDispatch" ENABLE ROW LEVEL SECURITY;
diff --git a/packages/documents/AGENTS.md b/packages/documents/AGENTS.md
index 635d7e0a06..857a3956f1 100644
--- a/packages/documents/AGENTS.md
+++ b/packages/documents/AGENTS.md
@@ -42,6 +42,7 @@ pnpm --filter @carbon/documents build # generates fonts.data.ts
## Cross-References
- `.claude/rules/pdf-generation-patterns.md` — full authoring guide
+- `.claude/rules/email-design.md` — the notification card every email template follows (anatomy, dark-mode-by-class, preview fixtures)
- `.claude/rules/document-template-customizer.md` — block template engine
- `.claude/rules/printing-system.md` — print queue / ZPL side
- `apps/erp/app/routes/file+/` — PDF serving routes
diff --git a/packages/documents/src/email/ChangelogEntryEmail.tsx b/packages/documents/src/email/ChangelogEntryEmail.tsx
new file mode 100644
index 0000000000..f931d404bd
--- /dev/null
+++ b/packages/documents/src/email/ChangelogEntryEmail.tsx
@@ -0,0 +1,131 @@
+import {
+ Body,
+ Button,
+ Container,
+ Heading,
+ Hr,
+ Link,
+ Preview,
+ Section,
+ Text
+} from "@react-email/components";
+import { Logo } from "./components/Logo";
+import { notificationStyles } from "./components/notificationStyles";
+import { EmailThemeProvider, getEmailThemeClasses } from "./components/Theme";
+
+interface Props {
+ title: string;
+ description?: string;
+ // Display date ("04 Sep 2026").
+ date?: string;
+ readUrl: string;
+ // Account → Notifications, where the newsletter is turned off.
+ manageUrl: string;
+}
+
+// No greeting: a subscriber is only an email address here.
+export const ChangelogEntryEmail = ({
+ title,
+ description,
+ date,
+ readUrl,
+ manageUrl
+}: Props) => {
+ const themeClasses = getEmailThemeClasses();
+
+ return (
+ <EmailThemeProvider
+ preview={<Preview>{description ?? title}</Preview>}
+ additionalHeadContent={<style>{notificationStyles}</style>}
+ >
+ <Body
+ className={`my-auto mx-auto font-sans nf-body ${themeClasses.body}`}
+ >
+ <Container
+ className={`my-[40px] mx-auto p-[36px] max-w-[560px] rounded-[16px] nf-card ${themeClasses.container}`}
+ style={{
+ borderRadius: 16,
+ borderStyle: "solid",
+ borderWidth: 1
+ }}
+ >
+ <Logo />
+
+ <Text
+ className={`text-[11px] leading-[16px] uppercase text-center font-medium m-0 mt-[40px] mb-[10px] nf-eyebrow ${themeClasses.mutedText}`}
+ style={{ letterSpacing: "0.14em" }}
+ >
+ {date ? `Changelog · ${date}` : "Changelog"}
+ </Text>
+
+ <Heading
+ className={`text-[26px] font-medium text-center tracking-tight p-0 mt-0 mb-[32px] mx-0 ${themeClasses.heading}`}
+ >
+ {title}
+ </Heading>
+
+ {description && (
+ <Section>
+ <Text
+ className={`text-[15px] leading-[26px] m-0 mb-[28px] text-center ${themeClasses.text}`}
+ >
+ {description}
+ </Text>
+ </Section>
+ )}
+
+ <Section className="text-center mb-[24px]">
+ <Button
+ href={readUrl}
+ className="nf-cta"
+ style={{
+ backgroundColor: "#0e0e0e",
+ borderColor: "#0e0e0e",
+ borderRadius: 10,
+ borderStyle: "solid",
+ borderWidth: 1,
+ color: "#ffffff",
+ display: "inline-block",
+ fontSize: 14,
+ fontWeight: 500,
+ padding: "13px 24px",
+ textAlign: "center",
+ textDecoration: "none"
+ }}
+ >
+ <span style={{ verticalAlign: "middle" }}>Changelog</span>
+ </Button>
+ </Section>
+
+ <Text
+ className={`text-[13px] leading-[20px] m-0 text-center break-all nf-fallback ${themeClasses.mutedText}`}
+ >
+ Or open this link in your browser:{" "}
+ <Link
+ href={readUrl}
+ className={`${themeClasses.mutedText} underline nf-fallback`}
+ >
+ {readUrl}
+ </Link>
+ </Text>
+
+ <Hr className={`my-[32px] nf-divider ${themeClasses.border}`} />
+ <Text
+ className={`text-[12px] leading-[18px] m-0 nf-fallback ${themeClasses.mutedText}`}
+ >
+ You&apos;re receiving this email because the changelog newsletter is
+ on in your Carbon account.{" "}
+ <Link
+ href={manageUrl}
+ className={`${themeClasses.mutedText} underline nf-fallback`}
+ >
+ Manage notification settings
+ </Link>
+ </Text>
+ </Container>
+ </Body>
+ </EmailThemeProvider>
+ );
+};
+
+export default ChangelogEntryEmail;
diff --git a/packages/documents/src/email/index.ts b/packages/documents/src/email/index.ts
index 3bdd26e2b1..3c0207b04a 100644
--- a/packages/documents/src/email/index.ts
+++ b/packages/documents/src/email/index.ts
@@ -1,3 +1,4 @@
+import ChangelogEntryEmail from "./ChangelogEntryEmail";
import CompanyDeletionWarningEmail from "./CompanyDeletionWarningEmail";
import GetStartedEmail from "./GetStartedEmail";
import ImplementationHubEmail from "./ImplementationHubEmail";
@@ -20,6 +21,7 @@ export {
} from "./WeeklyReminderEmail";
export {
+ ChangelogEntryEmail,
CompanyDeletionWarningEmail,
GetStartedEmail,
ImplementationHubEmail,
diff --git a/packages/documents/src/email/previews/ChangelogEntryEmail.tsx b/packages/documents/src/email/previews/ChangelogEntryEmail.tsx
new file mode 100644
index 0000000000..9ad075293b
--- /dev/null
+++ b/packages/documents/src/email/previews/ChangelogEntryEmail.tsx
@@ -0,0 +1,17 @@
+import ChangelogEntryEmail from "../ChangelogEntryEmail";
+
+export default function ChangelogEntryEmailPreview() {
+ return (
+ <ChangelogEntryEmail
+ title={"Finite-capacity scheduling"}
+ description={
+ "The scheduler now plans against real work-center capacity, with ability-gated operators and an explainable Gantt."
+ }
+ date={"04 Sep 2026"}
+ readUrl={
+ "https://docs.carbon.ms/changelog/2026-09-04-finite-capacity-scheduling"
+ }
+ manageUrl={"https://app.carbon.ms/x/account/notifications"}
+ />
+ );
+}
diff --git a/packages/jobs/src/inngest/functions/tasks/changelog-dispatch.email.test.ts b/packages/jobs/src/inngest/functions/tasks/changelog-dispatch.email.test.ts
new file mode 100644
index 0000000000..f1d4118478
--- /dev/null
+++ b/packages/jobs/src/inngest/functions/tasks/changelog-dispatch.email.test.ts
@@ -0,0 +1,30 @@
+import { render } from "@react-email/components";
+import { describe, expect, it, vi } from "vitest";
+
+// @carbon/env validates required vars at import; the template reaches it via Logo.
+vi.mock("@carbon/env", () => ({
+ getAppUrl: () => "https://app.carbon.ms",
+ NODE_ENV: "test",
+ VERCEL_ENV: undefined
+}));
+
+import { ChangelogEntryEmail } from "@carbon/documents/email";
+
+// Here rather than in @carbon/documents, whose test setup has no env.
+describe("ChangelogEntryEmail", () => {
+ it("renders the notification card with escaped title and the unsubscribe link", async () => {
+ const html = await render(
+ ChangelogEntryEmail({
+ title: "Ship <faster> & better",
+ description: "A & B",
+ date: "04 Sep 2026",
+ readUrl: "https://docs.carbon.ms/changelog/x",
+ manageUrl: "https://app.carbon.ms/x/account/notifications"
+ })
+ );
+ expect(html).toContain("Ship &lt;faster&gt; &amp; better");
+ expect(html).toContain("https://app.carbon.ms/x/account/notifications");
+ expect(html).toContain("nf-card");
+ expect(html).toContain("Changelog · 04 Sep 2026");
+ });
+});
diff --git a/packages/jobs/src/inngest/functions/tasks/changelog-dispatch.feed.test.ts b/packages/jobs/src/inngest/functions/tasks/changelog-dispatch.feed.test.ts
new file mode 100644
index 0000000000..1034e66468
--- /dev/null
+++ b/packages/jobs/src/inngest/functions/tasks/changelog-dispatch.feed.test.ts
@@ -0,0 +1,120 @@
+import { describe, expect, it } from "vitest";
+import {
+ displayDate,
+ entryEmailContent,
+ parseChangelogFeed,
+ planDispatch,
+ unescapeXml
+} from "./changelog-dispatch.feed";
+
+// The exact shape docs/app/changelog/rss.xml/route.ts emits.
+const FEED = `<?xml version="1.0" encoding="UTF-8"?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
+ <channel>
+ <title>Carbon Changelog</title>
+ <link>https://docs.carbon.ms/changelog</link>
+ <atom:link href="https://docs.carbon.ms/changelog/rss.xml" rel="self" type="application/rss+xml" />
+ <description>What&apos;s new in Carbon.</description>
+ <language>en</language>
+ <item>
+ <title>Finite-capacity scheduling</title>
+ <link>https://docs.carbon.ms/changelog/2026-09-04-finite-capacity-scheduling</link>
+ <guid isPermaLink="true">https://docs.carbon.ms/changelog/2026-09-04-finite-capacity-scheduling</guid>
+ <pubDate>04 Sep 2026 00:00:00 GMT</pubDate>
+ <description>Capacity-aware scheduling &amp; an explainable Gantt.</description>
+ <category>production</category>
+ <category>settings</category>
+ </item>
+ <item>
+ <title>Accounting sync for Xero, QuickBooks, and Rillet</title>
+ <link>https://docs.carbon.ms/changelog/2026-08-18-accounting-sync-engine</link>
+ <guid isPermaLink="true">https://docs.carbon.ms/changelog/2026-08-18-accounting-sync-engine</guid>
+ <pubDate>18 Aug 2026 00:00:00 GMT</pubDate>
+ <category>accounting</category>
+ </item>
+ </channel>
+</rss>`;
+
+describe("parseChangelogFeed", () => {
+ it("parses every item, preserving feed (newest-first) order", () => {
+ const entries = parseChangelogFeed(FEED);
+ expect(entries).toHaveLength(2);
+ expect(entries[0]).toEqual({
+ guid: "https://docs.carbon.ms/changelog/2026-09-04-finite-capacity-scheduling",
+ title: "Finite-capacity scheduling",
+ link: "https://docs.carbon.ms/changelog/2026-09-04-finite-capacity-scheduling",
+ description: "Capacity-aware scheduling & an explainable Gantt.",
+ pubDate: "04 Sep 2026 00:00:00 GMT",
+ tags: ["production", "settings"]
+ });
+ expect(entries[1]?.description).toBeNull();
+ expect(entries[1]?.tags).toEqual(["accounting"]);
+ });
+
+ it("returns [] for a feed with no items", () => {
+ expect(
+ parseChangelogFeed(FEED.replace(/<item>[\s\S]*<\/item>/, ""))
+ ).toEqual([]);
+ });
+
+ it("skips items missing guid, title, or link", () => {
+ const broken = FEED.replace(
+ '<guid isPermaLink="true">https://docs.carbon.ms/changelog/2026-09-04-finite-capacity-scheduling</guid>',
+ ""
+ );
+ const entries = parseChangelogFeed(broken);
+ expect(entries).toHaveLength(1);
+ expect(entries[0]?.tags).toEqual(["accounting"]);
+ });
+});
+
+describe("unescapeXml", () => {
+ it("round-trips the five escaped entities", () => {
+ expect(unescapeXml("&amp;&lt;&gt;&quot;&apos;")).toBe("&<>\"'");
+ });
+});
+
+describe("entryEmailContent", () => {
+ it("builds the subject and a text alternative carrying the links", () => {
+ const { subject, text } = entryEmailContent(
+ {
+ guid: "g",
+ title: "Ship faster",
+ link: "https://docs.carbon.ms/changelog/x",
+ description: null,
+ pubDate: null,
+ tags: []
+ },
+ "https://app.carbon.ms/x/account/notifications"
+ );
+ expect(subject).toBe("Ship faster");
+ expect(text).toContain("Changelog: https://docs.carbon.ms/changelog/x");
+ expect(text).toContain(
+ "Manage your changelog subscription: https://app.carbon.ms/x/account/notifications"
+ );
+ });
+});
+
+describe("displayDate", () => {
+ it("trims the feed pubDate to its day", () => {
+ expect(displayDate("04 Sep 2026 00:00:00 GMT")).toBe("04 Sep 2026");
+ expect(displayDate(null)).toBeUndefined();
+ });
+});
+
+describe("planDispatch", () => {
+ const entries = parseChangelogFeed(FEED);
+
+ it("bootstraps everything and sends nothing when the ledger is empty", () => {
+ const plan = planDispatch(entries, new Set(), true);
+ expect(plan.send).toEqual([]);
+ expect(plan.bootstrap).toHaveLength(2);
+ });
+
+ it("sends only entries missing from a seeded ledger", () => {
+ const seeded = new Set([entries[1]?.guid ?? ""]);
+ const plan = planDispatch(entries, seeded, false);
+ expect(plan.bootstrap).toEqual([]);
+ expect(plan.send.map((e) => e.guid)).toEqual([entries[0]?.guid]);
+ });
+});
diff --git a/packages/jobs/src/inngest/functions/tasks/changelog-dispatch.feed.ts b/packages/jobs/src/inngest/functions/tasks/changelog-dispatch.feed.ts
new file mode 100644
index 0000000000..aa01cb957f
--- /dev/null
+++ b/packages/jobs/src/inngest/functions/tasks/changelog-dispatch.feed.ts
@@ -0,0 +1,88 @@
+// Parses our own changelog feed (docs/app/changelog/rss.xml/route.ts), not RSS
+// in general: change this with that route.
+
+type ChangelogFeedEntry = {
+ guid: string;
+ title: string;
+ link: string;
+ description: string | null;
+ pubDate: string | null;
+ tags: string[];
+};
+
+const ENTITIES: Record<string, string> = {
+ "&amp;": "&",
+ "&lt;": "<",
+ "&gt;": ">",
+ "&quot;": '"',
+ "&apos;": "'"
+};
+
+export function unescapeXml(value: string): string {
+ return value.replace(/&(?:amp|lt|gt|quot|apos);/g, (m) => ENTITIES[m] ?? m);
+}
+
+function tagText(block: string, tag: string): string | null {
+ const match = block.match(new RegExp(`<${tag}[^>]*>([\\s\\S]*?)</${tag}>`));
+ const text = match?.[1];
+ return text !== undefined ? unescapeXml(text.trim()) : null;
+}
+
+// Keeps feed order (newest first). Items without a guid, title or link are
+// skipped: they cannot be dispatched or ledgered.
+export function parseChangelogFeed(xml: string): ChangelogFeedEntry[] {
+ const items = xml.match(/<item>[\s\S]*?<\/item>/g) ?? [];
+ const entries: ChangelogFeedEntry[] = [];
+ for (const item of items) {
+ const guid = tagText(item, "guid");
+ const title = tagText(item, "title");
+ const link = tagText(item, "link");
+ if (!guid || !title || !link) continue;
+ const tags = (item.match(/<category>[\s\S]*?<\/category>/g) ?? []).map(
+ (c) => unescapeXml(c.replace(/<\/?category>/g, "").trim())
+ );
+ entries.push({
+ guid,
+ title,
+ link,
+ description: tagText(item, "description"),
+ pubDate: tagText(item, "pubDate"),
+ tags
+ });
+ }
+ return entries;
+}
+
+// An empty ledger means the dispatcher has never run: record every entry
+// without sending, or the first run would mail the whole back-catalogue.
+export function planDispatch(
+ entries: ChangelogFeedEntry[],
+ ledgeredGuids: Set<string>,
+ ledgerIsEmpty: boolean
+): { send: ChangelogFeedEntry[]; bootstrap: ChangelogFeedEntry[] } {
+ if (ledgerIsEmpty) return { send: [], bootstrap: entries };
+ return {
+ send: entries.filter((entry) => !ledgeredGuids.has(entry.guid)),
+ bootstrap: []
+ };
+}
+
+// "04 Sep 2026 00:00:00 GMT" → "04 Sep 2026".
+export function displayDate(pubDate: string | null): string | undefined {
+ if (!pubDate) return undefined;
+ const day = pubDate.slice(0, 11).trim();
+ return day.length > 0 ? day : undefined;
+}
+
+// Subject and plain-text part of an entry email; the HTML part is
+// ChangelogEntryEmail.
+export function entryEmailContent(
+ entry: ChangelogFeedEntry,
+ manageUrl: string
+): { subject: string; text: string } {
+ const description = entry.description ?? "";
+ return {
+ subject: entry.title,
+ text: `${entry.title}\n\n${description}\n\nChangelog: ${entry.link}\n\nManage your changelog subscription: ${manageUrl}`
+ };
+}
diff --git a/packages/jobs/src/inngest/functions/tasks/changelog-dispatch.ts b/packages/jobs/src/inngest/functions/tasks/changelog-dispatch.ts
new file mode 100644
index 0000000000..0a50768f37
--- /dev/null
+++ b/packages/jobs/src/inngest/functions/tasks/changelog-dispatch.ts
@@ -0,0 +1,227 @@
+import { ChangelogEntryEmail } from "@carbon/documents/email";
+import { ERP_URL } from "@carbon/env";
+import { DEFAULT_FROM, sendEmail } from "@carbon/lib/email.server";
+import { NotificationTopic } from "@carbon/notifications";
+import { render } from "@react-email/components";
+import { getJobDatabaseClient } from "../../../db";
+import { inngest } from "../../client";
+import {
+ displayDate,
+ entryEmailContent,
+ parseChangelogFeed,
+ planDispatch
+} from "./changelog-dispatch.feed";
+
+/**
+ * Emails new changelog entries to newsletter subscribers. Runs when
+ * `carbon/changelog-dispatch` is sent after an entry is published; the
+ * `changelogDispatch` ledger makes sending it again safe.
+ */
+
+const CHANGELOG_FEED_URL =
+ process.env.CHANGELOG_FEED_URL ??
+ (process.env.INNGEST_DEV
+ ? "http://localhost:3002/changelog/rss.xml"
+ : "https://docs.carbon.ms/changelog/rss.xml");
+
+// A run sent right after a merge can beat the docs deploy, so the feed is
+// re-checked a few times before giving up.
+const FEED_ATTEMPTS = 5;
+
+// One durable step per chunk of recipients: a retry resumes at the failed
+// chunk instead of re-sending the ones before it.
+const SEND_CHUNK_SIZE = 50;
+
+// Account → Notifications, where a reader turns the newsletter off.
+const MANAGE_URL = `${ERP_URL.replace(/\/$/, "")}/x/account/notifications`;
+
+type DispatchPlan = ReturnType<typeof planDispatch>;
+
+// The preference is per company but the newsletter is not, so a user opted in
+// from two companies still gets one email.
+async function getNewsletterRecipients(): Promise<string[]> {
+ const db = getJobDatabaseClient();
+ const rows = await db
+ .selectFrom("notificationPreference")
+ .innerJoin("user", "user.id", "notificationPreference.userId")
+ .select(["user.email as email"])
+ .where("notificationPreference.topic", "=", NotificationTopic.Changelog)
+ .where("notificationPreference.channel", "=", "email")
+ .where("notificationPreference.enabled", "=", true)
+ .where("user.active", "=", true)
+ .distinct()
+ .orderBy("user.email")
+ .execute();
+ return rows.map((row) => row.email).filter((email) => email.length > 0);
+}
+
+// Returns how many were sent; 0 with no error means email is not configured.
+async function sendEntryToRecipients(
+ entry: DispatchPlan["send"][number],
+ recipients: string[]
+): Promise<number> {
+ // No List-Unsubscribe-Post: one-click unsubscribe needs an unauthenticated
+ // endpoint, and the preference lives behind sign-in.
+ const { subject, text } = entryEmailContent(entry, MANAGE_URL);
+ const html = await render(
+ ChangelogEntryEmail({
+ title: entry.title,
+ description: entry.description ?? undefined,
+ date: displayDate(entry.pubDate),
+ readUrl: entry.link,
+ manageUrl: MANAGE_URL
+ })
+ );
+
+ let sent = 0;
+ // Sequential: the mail relay rate-limits.
+ for (const to of recipients) {
+ const response = await sendEmail({
+ from: DEFAULT_FROM,
+ to,
+ subject,
+ html,
+ text,
+ headers: { "List-Unsubscribe": `<${MANAGE_URL}>` }
+ });
+ if (response.error) {
+ throw new Error(`Email error: ${response.error.message}`);
+ }
+ if (response.data) sent += 1;
+ }
+ return sent;
+}
+
+async function planFromLiveFeed(): Promise<DispatchPlan> {
+ const response = await fetch(CHANGELOG_FEED_URL);
+ if (!response.ok) {
+ throw new Error(
+ `Failed to fetch changelog feed: ${response.status} ${response.statusText}`
+ );
+ }
+ const entries = parseChangelogFeed(await response.text());
+ if (entries.length === 0) return { send: [], bootstrap: [] };
+
+ const db = getJobDatabaseClient();
+ const ledgerCount = await db
+ .selectFrom("changelogDispatch")
+ .select(db.fn.countAll<number>().as("count"))
+ .executeTakeFirstOrThrow();
+ const ledgerIsEmpty = Number(ledgerCount.count) === 0;
+
+ const seen = ledgerIsEmpty
+ ? []
+ : await db
+ .selectFrom("changelogDispatch")
+ .select("guid")
+ .where(
+ "guid",
+ "in",
+ entries.map((e) => e.guid)
+ )
+ .execute();
+ return planDispatch(
+ entries,
+ new Set(seen.map((row) => row.guid)),
+ ledgerIsEmpty
+ );
+}
+
+export const changelogDispatchFunction = inngest.createFunction(
+ { id: "changelog-dispatch", retries: 2, concurrency: { limit: 1 } },
+ { event: "carbon/changelog-dispatch" },
+ async ({ step, logger }) => {
+ let plan: DispatchPlan = { send: [], bootstrap: [] };
+ for (let attempt = 1; attempt <= FEED_ATTEMPTS; attempt++) {
+ plan = await step.run(`fetch-feed-${attempt}`, planFromLiveFeed);
+ if (
+ plan.send.length > 0 ||
+ plan.bootstrap.length > 0 ||
+ attempt === FEED_ATTEMPTS
+ ) {
+ break;
+ }
+ await step.sleep(`wait-for-deploy-${attempt}`, "2m");
+ }
+
+ if (plan.bootstrap.length > 0) {
+ // First run: record the current feed without sending, so launch does
+ // not mail the whole back-catalogue.
+ await step.run("bootstrap-ledger", async () => {
+ const db = getJobDatabaseClient();
+ await db
+ .insertInto("changelogDispatch")
+ .values(
+ plan.bootstrap.map((entry) => ({
+ guid: entry.guid,
+ title: entry.title,
+ description: entry.description,
+ // NOW() would give every row the same time and make the What's new
+ // panel's "latest" arbitrary. Postgres parses the RFC 822 date.
+ ...(entry.pubDate ? { dispatchedAt: entry.pubDate } : {}),
+ emailsSent: 0
+ }))
+ )
+ .onConflict((oc) => oc.column("guid").doNothing())
+ .execute();
+ });
+ logger.info("Bootstrapped changelog dispatch ledger — nothing sent", {
+ entries: plan.bootstrap.length
+ });
+ return { dispatched: 0, bootstrapped: plan.bootstrap.length };
+ }
+
+ const newEntries = plan.send;
+ if (newEntries.length === 0) {
+ logger.info("No undispatched changelog entries");
+ return { dispatched: 0 };
+ }
+
+ // Feed is newest-first; send oldest-first so a backlog arrives in order.
+ let dispatched = 0;
+ for (const entry of [...newEntries].reverse()) {
+ // A step, so every chunk and retry works from the same list.
+ const subscribers = await step.run(
+ `recipients-${entry.guid}`,
+ getNewsletterRecipients
+ );
+
+ let emailsSent = 0;
+ for (let i = 0; i < subscribers.length; i += SEND_CHUNK_SIZE) {
+ const chunk = subscribers.slice(i, i + SEND_CHUNK_SIZE);
+ emailsSent += await step.run(
+ `dispatch-${entry.guid}-${i / SEND_CHUNK_SIZE}`,
+ () => sendEntryToRecipients(entry, chunk)
+ );
+ }
+ if (subscribers.length > 0 && emailsSent === 0) {
+ // Ledgering it now would mark it sent for good, and nobody would get
+ // it once mail is configured.
+ throw new Error(
+ `No changelog email was delivered for ${entry.guid} — mail transport not configured; refusing to ledger the dispatch`
+ );
+ }
+
+ await step.run(`ledger-${entry.guid}`, async () => {
+ const db = getJobDatabaseClient();
+ await db
+ .insertInto("changelogDispatch")
+ .values({
+ guid: entry.guid,
+ title: entry.title,
+ description: entry.description,
+ emailsSent
+ })
+ .onConflict((oc) => oc.column("guid").doNothing())
+ .execute();
+ });
+ dispatched += 1;
+ logger.info("Dispatched changelog entry", {
+ guid: entry.guid,
+ emailsSent
+ });
+ }
+
+ return { dispatched };
+ }
+);
diff --git a/packages/jobs/src/inngest/functions/tasks/index.ts b/packages/jobs/src/inngest/functions/tasks/index.ts
index bfcfdf2bac..fc323d38be 100644
--- a/packages/jobs/src/inngest/functions/tasks/index.ts
+++ b/packages/jobs/src/inngest/functions/tasks/index.ts
@@ -1,5 +1,6 @@
export { assemblyConvertFunction } from "./assembly-convert";
export { assemblyPlanFunction } from "./assembly-plan";
+export { changelogDispatchFunction } from "./changelog-dispatch";
export { companyExportFunction } from "./company-export";
export { companyImportFunction } from "./company-import";
export {
diff --git a/packages/jobs/src/inngest/index.ts b/packages/jobs/src/inngest/index.ts
index ae140d8b6f..286dc0b22c 100644
--- a/packages/jobs/src/inngest/index.ts
+++ b/packages/jobs/src/inngest/index.ts
@@ -75,6 +75,7 @@ import {
import {
assemblyConvertFunction,
assemblyPlanFunction,
+ changelogDispatchFunction,
companyExportFunction,
companyImportFunction,
companyRestoreFinalizeFunction,
@@ -141,6 +142,7 @@ export const functions = [
onboardFunction,
printJobFunction,
printJobDeliverFunction,
+ changelogDispatchFunction,
// Scheduled
cleanupFunction,
dispatchFunction,
diff --git a/packages/lib/src/events.ts b/packages/lib/src/events.ts
index 00911fb8b7..c2efe90744 100644
--- a/packages/lib/src/events.ts
+++ b/packages/lib/src/events.ts
@@ -71,6 +71,11 @@ export type Events = {
};
};
+ // Sent after a changelog entry is published; platform-level, no companyId.
+ "carbon/changelog-dispatch": {
+ data: Record<string, never>;
+ };
+
// Assembly model conversion (CAD → GLB + assembly graph)
"carbon/assembly-convert": {
data: {
diff --git a/packages/locale/locales/de/erp.po b/packages/locale/locales/de/erp.po
index 64343a9317..402a9f7b93 100644
--- a/packages/locale/locales/de/erp.po
+++ b/packages/locale/locales/de/erp.po
@@ -3699,6 +3699,12 @@ msgstr "Typ ändern"
msgid "Changed By"
msgstr "Geändert von"
+msgid "Changelog"
+msgstr "Änderungslog"
+
+msgid "Changelog newsletter"
+msgstr "Änderungslog-Newsletter"
+
msgid "Changes"
msgstr "Änderungen"
diff --git a/packages/locale/locales/en/erp.po b/packages/locale/locales/en/erp.po
index 2d01833972..09630aff18 100644
--- a/packages/locale/locales/en/erp.po
+++ b/packages/locale/locales/en/erp.po
@@ -3699,6 +3699,12 @@ msgstr "Change Type"
msgid "Changed By"
msgstr "Changed By"
+msgid "Changelog"
+msgstr "Changelog"
+
+msgid "Changelog newsletter"
+msgstr "Changelog newsletter"
+
msgid "Changes"
msgstr "Changes"
diff --git a/packages/locale/locales/es/erp.po b/packages/locale/locales/es/erp.po
index ec55f8128b..16a37f12e6 100644
--- a/packages/locale/locales/es/erp.po
+++ b/packages/locale/locales/es/erp.po
@@ -3699,6 +3699,12 @@ msgstr "Cambiar Tipo"
msgid "Changed By"
msgstr "Cambiado por"
+msgid "Changelog"
+msgstr "Registro de cambios"
+
+msgid "Changelog newsletter"
+msgstr "Boletín de cambios"
+
msgid "Changes"
msgstr "Cambios"
diff --git a/packages/locale/locales/fr/erp.po b/packages/locale/locales/fr/erp.po
index 7e456acd75..622830f9df 100644
--- a/packages/locale/locales/fr/erp.po
+++ b/packages/locale/locales/fr/erp.po
@@ -3699,6 +3699,12 @@ msgstr "Changer le type"
msgid "Changed By"
msgstr "Modifié par"
+msgid "Changelog"
+msgstr "Journal des modifications"
+
+msgid "Changelog newsletter"
+msgstr "Bulletin du journal des modifications"
+
msgid "Changes"
msgstr "Modifications"
diff --git a/packages/locale/locales/hi/erp.po b/packages/locale/locales/hi/erp.po
index a2656438d2..c94db886bd 100644
--- a/packages/locale/locales/hi/erp.po
+++ b/packages/locale/locales/hi/erp.po
@@ -3699,6 +3699,12 @@ msgstr "प्रकार बदलें"
msgid "Changed By"
msgstr "द्वारा परिवर्तित"
+msgid "Changelog"
+msgstr "परिवर्तन लॉग"
+
+msgid "Changelog newsletter"
+msgstr "परिवर्तन न्यूजलेटर"
+
msgid "Changes"
msgstr "परिवर्तन"
diff --git a/packages/locale/locales/it/erp.po b/packages/locale/locales/it/erp.po
index 81d619798e..25443fa6b0 100644
--- a/packages/locale/locales/it/erp.po
+++ b/packages/locale/locales/it/erp.po
@@ -3699,6 +3699,12 @@ msgstr "Cambia Tipo"
msgid "Changed By"
msgstr "Modificato da"
+msgid "Changelog"
+msgstr "Cronologia"
+
+msgid "Changelog newsletter"
+msgstr "Newsletter cronologia"
+
msgid "Changes"
msgstr "Modifiche"
diff --git a/packages/locale/locales/ja/erp.po b/packages/locale/locales/ja/erp.po
index 5e3f47000b..c6474450b7 100644
--- a/packages/locale/locales/ja/erp.po
+++ b/packages/locale/locales/ja/erp.po
@@ -3699,6 +3699,12 @@ msgstr "タイプを変更"
msgid "Changed By"
msgstr "変更者"
+msgid "Changelog"
+msgstr "変更ログ"
+
+msgid "Changelog newsletter"
+msgstr "変更ログニュースレター"
+
msgid "Changes"
msgstr "変更"
diff --git a/packages/locale/locales/ko/erp.po b/packages/locale/locales/ko/erp.po
index cd3d5ca459..34a094b09f 100644
--- a/packages/locale/locales/ko/erp.po
+++ b/packages/locale/locales/ko/erp.po
@@ -3699,6 +3699,12 @@ msgstr "변경 유형"
msgid "Changed By"
msgstr "변경자"
+msgid "Changelog"
+msgstr "변경 로그"
+
+msgid "Changelog newsletter"
+msgstr "변경 로그 뉴스레터"
+
msgid "Changes"
msgstr "변경 사항"
diff --git a/packages/locale/locales/pl/erp.po b/packages/locale/locales/pl/erp.po
index 9785d3f4dc..af6a2a9296 100644
--- a/packages/locale/locales/pl/erp.po
+++ b/packages/locale/locales/pl/erp.po
@@ -3699,6 +3699,12 @@ msgstr "Zmień typ"
msgid "Changed By"
msgstr "Zmienione przez"
+msgid "Changelog"
+msgstr "Historia zmian"
+
+msgid "Changelog newsletter"
+msgstr "Newsletter Historii zmian"
+
msgid "Changes"
msgstr "Zmiany"
diff --git a/packages/locale/locales/pt/erp.po b/packages/locale/locales/pt/erp.po
index a2915e3273..2f06b30226 100644
--- a/packages/locale/locales/pt/erp.po
+++ b/packages/locale/locales/pt/erp.po
@@ -3699,6 +3699,12 @@ msgstr "Alterar Tipo"
msgid "Changed By"
msgstr "Alterado por"
+msgid "Changelog"
+msgstr "Histórico de Mudanças"
+
+msgid "Changelog newsletter"
+msgstr "Boletim de Mudanças"
+
msgid "Changes"
msgstr "Alterações"
diff --git a/packages/locale/locales/ru/erp.po b/packages/locale/locales/ru/erp.po
index 15c1fe4ca8..91e3bafb87 100644
--- a/packages/locale/locales/ru/erp.po
+++ b/packages/locale/locales/ru/erp.po
@@ -3699,6 +3699,12 @@ msgstr "Изменить тип"
msgid "Changed By"
msgstr "Изменено"
+msgid "Changelog"
+msgstr "Журнал изменений"
+
+msgid "Changelog newsletter"
+msgstr "Рассылка журнала изменений"
+
msgid "Changes"
msgstr "Изменения"
diff --git a/packages/locale/locales/tr/erp.po b/packages/locale/locales/tr/erp.po
index 0e6e1f637b..14a6f1a0f6 100644
--- a/packages/locale/locales/tr/erp.po
+++ b/packages/locale/locales/tr/erp.po
@@ -3699,6 +3699,12 @@ msgstr "Tipi Değiştir"
msgid "Changed By"
msgstr "Değiştiren"
+msgid "Changelog"
+msgstr "Değişiklik Günlüğü"
+
+msgid "Changelog newsletter"
+msgstr "Değişiklik Günlüğü Haber Bülteni"
+
msgid "Changes"
msgstr "Değişiklikler"
diff --git a/packages/locale/locales/zh/erp.po b/packages/locale/locales/zh/erp.po
index 6d17e62be7..f380d5f6de 100644
--- a/packages/locale/locales/zh/erp.po
+++ b/packages/locale/locales/zh/erp.po
@@ -3699,6 +3699,12 @@ msgstr "更改类型"
msgid "Changed By"
msgstr "更改者"
+msgid "Changelog"
+msgstr "更新日志"
+
+msgid "Changelog newsletter"
+msgstr "更新日志通讯"
+
msgid "Changes"
msgstr "更改"
diff --git a/packages/notifications/AGENTS.md b/packages/notifications/AGENTS.md
index ef31cc857d..b73cc8403b 100644
--- a/packages/notifications/AGENTS.md
+++ b/packages/notifications/AGENTS.md
@@ -27,7 +27,7 @@ pnpm --filter @carbon/notifications typecheck # tsgo --noEmit
## Key Patterns
-- **Enums + pure mapping helpers, no I/O** — `NotificationEvent`, `NotificationTopic`, `NotificationDestination`; `getNotificationTopic`, email heading/CTA helpers, and `USER_FACING_NOTIFICATION_TOPICS` (display order for the account notification-settings page — when adding a `NotificationTopic`, add it here too or it won't appear on that page)
+- **Enums + pure mapping helpers, no I/O** — `NotificationEvent`, `NotificationTopic`, `NotificationDestination`; `getNotificationTopic`, email heading/CTA helpers, and `USER_FACING_NOTIFICATION_TOPICS` (display order for the account notification-settings page — when adding a `NotificationTopic`, add it here too or it won't appear on that page), plus `getNotificationTopicChannels` (which switches a topic's row offers) and `isNotificationTopicEnabledByDefault` (what no preference row means — `false` only for the opt-in, email-only `Changelog` newsletter)
- **Body rendering lives here, all three renditions together** — `renderInlineLinks` (the strict `[label](https://origin/…)` matcher; a security boundary, since a workflow's message body is customer-authored) plus `renderSlackMrkdwn` / `escapeSlackText` for the Slack rendition. The in-app topbar and `NotificationEmail.tsx` consume the segments directly. A fourth channel adds its rendition beside these, not in the fan-out job
- **`NotificationEvent.Workflow` is the payload-text kind** — every other event's content is read from its source document; this one carries `title` / `body` on the `carbon/notify` payload and reads nothing. Raised by the workflows notify action (`packages/jobs/src/workflows/actions/notify.ts`), topic `General`
- **inApp is always included** — regardless of caller-specified destinations
diff --git a/packages/notifications/src/index.test.ts b/packages/notifications/src/index.test.ts
index f57c8acda7..af2b20ef71 100644
--- a/packages/notifications/src/index.test.ts
+++ b/packages/notifications/src/index.test.ts
@@ -1,5 +1,12 @@
import { describe, expect, it } from "vitest";
-import { renderInlineLinks, renderSlackMrkdwn } from "./index";
+import {
+ getNotificationTopicChannels,
+ isNotificationTopicEnabledByDefault,
+ NotificationTopic,
+ renderInlineLinks,
+ renderSlackMrkdwn,
+ USER_FACING_NOTIFICATION_TOPICS
+} from "./index";
const ORIGIN = "https://app.carbon.ms";
const HREF = `${ORIGIN}/api/link?event=workflow&documentId=so_1`;
@@ -86,3 +93,31 @@ describe("renderSlackMrkdwn", () => {
expect(renderSlackMrkdwn("", ORIGIN)).toBe("");
});
});
+
+describe("notification topic settings", () => {
+ it("lists the changelog newsletter on the settings page", () => {
+ expect(USER_FACING_NOTIFICATION_TOPICS).toContain(
+ NotificationTopic.Changelog
+ );
+ });
+
+ it("offers only email for the changelog newsletter", () => {
+ expect(getNotificationTopicChannels(NotificationTopic.Changelog)).toEqual([
+ "email"
+ ]);
+ expect(getNotificationTopicChannels(NotificationTopic.Job)).toEqual([
+ "email",
+ "slack"
+ ]);
+ });
+
+ it("treats a missing preference as off only for the opt-in newsletter", () => {
+ expect(
+ isNotificationTopicEnabledByDefault(NotificationTopic.Changelog)
+ ).toBe(false);
+ for (const topic of USER_FACING_NOTIFICATION_TOPICS) {
+ if (topic === NotificationTopic.Changelog) continue;
+ expect(isNotificationTopicEnabledByDefault(topic)).toBe(true);
+ }
+ });
+});
diff --git a/packages/notifications/src/index.ts b/packages/notifications/src/index.ts
index d859ec5dca..80826a7438 100644
--- a/packages/notifications/src/index.ts
+++ b/packages/notifications/src/index.ts
@@ -60,6 +60,8 @@ export enum NotificationEvent {
// `notification.topic` column, so renaming any of these is a migration.
export enum NotificationTopic {
Approval = "approval",
+ // The changelog newsletter: opt-in and email-only.
+ Changelog = "changelog",
General = "general",
Inventory = "inventory",
Items = "items",
@@ -86,9 +88,37 @@ export const USER_FACING_NOTIFICATION_TOPICS = [
NotificationTopic.Maintenance,
NotificationTopic.Training,
NotificationTopic.Suggestion,
- NotificationTopic.General
+ NotificationTopic.General,
+ NotificationTopic.Changelog
] as const satisfies readonly NotificationTopic[];
+// In-app is always delivered, so it is not a preference channel.
+export type NotificationPreferenceChannel = "email" | "slack";
+
+export function getNotificationTopicChannels(
+ topic: NotificationTopic
+): readonly NotificationPreferenceChannel[] {
+ switch (topic) {
+ case NotificationTopic.Changelog:
+ return ["email"];
+ default:
+ return ["email", "slack"];
+ }
+}
+
+// What no preference row means. The newsletter is opt-in: its dispatcher only
+// mails users with an enabled row.
+export function isNotificationTopicEnabledByDefault(
+ topic: NotificationTopic
+): boolean {
+ switch (topic) {
+ case NotificationTopic.Changelog:
+ return false;
+ default:
+ return true;
+ }
+}
+
// A labeled fact attached to a notification (e.g. Customer / Acme Corp),
// rendered in the email, Slack text, and notification.payload.details.
export type NotificationDetail = {