🪢 Open source agent evals & observability: Trace, evaluate, and improve LLM applications with one open platform.
TypeScript analyticsautogenevaluationlangchainlarge-language-modelsllama-indexllmllm-evaluationllm-observabilityllmopsmonitoringobservabilityopen-sourceopenaiplaygroundprompt-engineeringprompt-managementself-hostedycombinator
feat(web): reframe migration headline around the compatibility deadline (#16776)
Max Deichmannab616dadbdb6
diff --git a/web/src/components/layouts/app-layout/right-drawer/MobileRightDrawer.clienttest.tsx b/web/src/components/layouts/app-layout/right-drawer/MobileRightDrawer.clienttest.tsxindex 33da0dbf1d..983a039b2b 100644--- a/web/src/components/layouts/app-layout/right-drawer/MobileRightDrawer.clienttest.tsx+++ b/web/src/components/layouts/app-layout/right-drawer/MobileRightDrawer.clienttest.tsx@@ -1,16 +1,21 @@-import { render } from "@testing-library/react";+import { render, screen } from "@testing-library/react";import { MobileRightDrawer } from "@/src/components/layouts/app-layout/right-drawer/MobileRightDrawer";+const mocks = vi.hoisted(() => ({+ supportOpen: true,+ migrationOpen: false,+}));+vi.mock("@/src/features/support-chat/SupportDrawerProvider", () => ({useSupportDrawer: () => ({- open: true,+ open: mocks.supportOpen,setOpen: vi.fn(),}),}));vi.mock("@/src/features/v4-migration/V4MigrationPanelProvider", () => ({useV4MigrationPanel: () => ({- open: false,+ open: mocks.migrationOpen,setOpen: vi.fn(),}),}));@@ -23,6 +28,10 @@ vi.mock("@/src/features/v4-migration/V4MigrationPanel", () => ({V4MigrationPanel: () => null,}));+vi.mock("@/src/features/v4-migration/V4MigrationContent", () => ({+ useV4MigrationTitle: () => "Ensure compatibility after November 16",+}));+function mountOverlayRoot() {const overlayRoot = document.createElement("div");overlayRoot.setAttribute("data-overlay-root", "");@@ -43,6 +52,8 @@ function mountOverlayRoot() {describe("MobileRightDrawer", () => {beforeEach(() => {+ mocks.supportOpen = true;+ mocks.migrationOpen = false;mountOverlayRoot();});@@ -61,4 +72,19 @@ describe("MobileRightDrawer", () => {expect(drawer).not.toBeNull();expect(drawer?.className).not.toContain("min-h-screen-with-banner");});++ it("includes the compatibility deadline in the accessible migration title", () => {+ mocks.supportOpen = false;+ mocks.migrationOpen = true;++ render(+ <MobileRightDrawer>+ <div>page</div>+ </MobileRightDrawer>,+ );++ expect(+ screen.getByText("Ensure compatibility after November 16"),+ ).toBeInTheDocument();+ });});diff --git a/web/src/components/layouts/app-layout/right-drawer/MobileRightDrawer.tsx b/web/src/components/layouts/app-layout/right-drawer/MobileRightDrawer.tsxindex 3e9147252a..190d9e485b 100644--- a/web/src/components/layouts/app-layout/right-drawer/MobileRightDrawer.tsx+++ b/web/src/components/layouts/app-layout/right-drawer/MobileRightDrawer.tsx@@ -10,11 +10,13 @@ import { useSupportDrawer } from "@/src/features/support-chat/SupportDrawerProviimport { SupportDrawer } from "@/src/features/support-chat/SupportDrawer";import { useV4MigrationPanel } from "@/src/features/v4-migration/V4MigrationPanelProvider";import { V4MigrationPanel } from "@/src/features/v4-migration/V4MigrationPanel";+import { useV4MigrationTitle } from "@/src/features/v4-migration/V4MigrationContent";export function MobileRightDrawer({ children }: PropsWithChildren) {const { open: supportOpen, setOpen: setSupportOpen } = useSupportDrawer();const { open: migrationOpen, setOpen: setMigrationOpen } =useV4MigrationPanel();+ const migrationTitle = useV4MigrationTitle();return (<>@@ -64,10 +66,10 @@ export function MobileRightDrawer({ children }: PropsWithChildren) {<div className="bg-muted h-2 w-20 rounded-full" /></div>{/* sr-only for screen readers and accessibility */}- <DrawerTitle className="sr-only">Upgrade to v4</DrawerTitle>+ <DrawerTitle className="sr-only">{migrationTitle}</DrawerTitle><DrawerDescription className="sr-only">- Information about migrating to Langfuse v4 and upcoming- deprecations.+ Action items to keep your integrations compatible with Langfuse v4+ and upcoming deprecations.</DrawerDescription></DrawerHeader><V4MigrationPaneldiff --git a/web/src/features/v4-migration/V4MigrationContent.clienttest.tsx b/web/src/features/v4-migration/V4MigrationContent.clienttest.tsxindex fcbf339e63..2d3d6ead94 100644--- a/web/src/features/v4-migration/V4MigrationContent.clienttest.tsx+++ b/web/src/features/v4-migration/V4MigrationContent.clienttest.tsx@@ -1264,6 +1264,7 @@ describe("V4MigrationDetailsContent", () => {describe("V4MigrationHeaderContent", () => {beforeEach(() => {+ mocks.env.NEXT_PUBLIC_LANGFUSE_CLOUD_REGION = "US";mocks.migrationData.evals = { status: "loaded", count: 0 };mocks.migrationData.experiments = {status: "loaded",@@ -1283,13 +1284,18 @@ describe("V4MigrationHeaderContent", () => {);});- it("uses the project-independent upgrade title and requested description", () => {+ it("uses the project-independent compatibility title and requested description", () => {render(<V4MigrationHeaderContent readiness="action-needed" />);- expect(screen.getByText("Upgrade to v4")).toBeInTheDocument();+ // The title stays off the version number: the app shell already shows a v4+ // build, so a "upgrade to v4" headline read as a contradiction.+ expect(+ screen.getByText("Ensure compatibility after November 16"),+ ).toBeInTheDocument();+ expect(screen.queryByText("Upgrade to v4")).not.toBeInTheDocument();expect(screen.queryByText(/Project 1/)).not.toBeInTheDocument();expect(screen.getByText(/Langfuse v4 is live/)).toHaveTextContent(- "Langfuse v4 is live: a re-architecture of our data model and database tables. It is up to 165× more performant in UI and on APIs. It also enables new features such as full-text search, a new filter search bar, alerts, code evaluators, and the Langfuse Assistant. Complete the action items below to switch this project over. See docs.",+ "Langfuse v4 is live: a re-architecture of our data model and database tables. It is up to 165× more performant in UI and on APIs. It also enables new features such as full-text search, a new filter search bar, alerts, code evaluators, and the Langfuse Assistant. Complete the action items below to avoid disruption. See docs.",);expect(screen.getByRole("link", { name: "full-text search" }),@@ -1323,7 +1329,7 @@ describe("V4MigrationHeaderContent", () => {expect(screen.getByText(/some features may stop working/),).toHaveTextContent(- "After November 16, 2026 some features may stop working without a v4 upgrade.",+ "After November 16, 2026 some features may stop working if you don't update integrations.",);expect(screen.getByRole("link", { name: "November 16, 2026" }),@@ -1337,10 +1343,11 @@ describe("V4MigrationHeaderContent", () => {render(<V4MigrationHeaderContent readiness="action-needed" />);+ expect(screen.getByText("Ensure compatibility")).toBeInTheDocument();expect(screen.getByText(/features may stop working/)).toHaveTextContent(- "Some features may stop working without an upgrade once your administrator disables the legacy mode.",+ "Some features may stop working if you don't update integrations before your administrator disables the legacy mode.",);- expect(screen.queryByText(/November 16, 2026/)).not.toBeInTheDocument();+ expect(screen.queryByText(/November 16/)).not.toBeInTheDocument();expect(screen.queryByRole("link", { name: "November 16, 2026" }),).not.toBeInTheDocument();@@ -1350,7 +1357,9 @@ describe("V4MigrationHeaderContent", () => {// The modal host floats the dialog's fallback close button over the// body's top-right corner; without the gutter it overlaps the title.render(<V4MigrationHeaderContent titleRowClassName="pr-6" />);- expect(screen.getByText("Upgrade to v4").parentElement).toHaveClass("pr-6");+ expect(+ screen.getByText("Ensure compatibility after November 16").parentElement,+ ).toHaveClass("pr-6");});it("keeps the pitch but drops the action ask for ready or unresolved projects", () => {diff --git a/web/src/features/v4-migration/V4MigrationContent.tsx b/web/src/features/v4-migration/V4MigrationContent.tsxindex 1201e51756..91045d0f86 100644--- a/web/src/features/v4-migration/V4MigrationContent.tsx+++ b/web/src/features/v4-migration/V4MigrationContent.tsx@@ -79,6 +79,8 @@ const V4_DOCS_URL = "https://langfuse.com/docs/v4";const V4_TIMELINE_URL = `${V4_DOCS_URL}#timeline`;// Consumed by the status page deadline copy.export const V4_MIGRATION_DEADLINE = "November 16, 2026";+// Headline form of the deadline; the year is noise in a title.+const V4_MIGRATION_DEADLINE_SHORT = "November 16";const SDK_UPGRADE_URL ="https://langfuse.com/docs/observability/sdk/upgrade-path";const OTEL_V4_MIGRATION_URL =@@ -1207,14 +1209,26 @@ export function V4MigrationDocsLink() {);}+/**+ * Headline for the migration surfaces. It names the compatibility deadline+ * rather than a version: the app shell already shows a v4 build number, so a+ * "upgrade to v4" title reads as a contradiction to users whose integrations,+ * not their deployment, are the thing left to update.+ */+export function useV4MigrationTitle(): string {+ return useHasV4MigrationDeadline()+ ? `Ensure compatibility after ${V4_MIGRATION_DEADLINE_SHORT}`+ : "Ensure compatibility";+}+export function V4MigrationDeadlineNote() {const hasDeadline = useHasV4MigrationDeadline();if (!hasDeadline) {return (<p>- Some features may stop working without an upgrade once your- administrator disables the legacy mode.+ Some features may stop working if you don't update integrations+ before your administrator disables the legacy mode.</p>);}@@ -1228,7 +1242,7 @@ export function V4MigrationDeadlineNote() {>{V4_MIGRATION_DEADLINE}</ExternalLink>{" "}- some features may stop working without a v4 upgrade.+ some features may stop working if you don't update integrations.</p>);}@@ -1248,6 +1262,7 @@ export function V4MigrationHeaderContent({readiness?: ProjectMigrationReadiness;}) {const actionNeeded = readiness === "action-needed";+ const title = useV4MigrationTitle();return (<>@@ -1257,7 +1272,7 @@ export function V4MigrationHeaderContent({titleRowClassName,)}>- <p className="min-w-0 text-lg font-bold">Upgrade to v4</p>+ <p className="min-w-0 text-lg font-bold">{title}</p></div><div className="text-muted-foreground flex flex-col gap-2 text-sm leading-relaxed"><p>@@ -1300,7 +1315,7 @@ export function V4MigrationHeaderContent({</ExternalLink>.{actionNeeded- ? " Complete the action items below to switch this project over."+ ? " Complete the action items below to avoid disruption.": ""}{" "}<V4MigrationDocsLink /></p>diff --git a/web/src/features/v4-migration/V4MigrationStatusPage.clienttest.tsx b/web/src/features/v4-migration/V4MigrationStatusPage.clienttest.tsxindex f0fc01e4c8..953438e1f9 100644--- a/web/src/features/v4-migration/V4MigrationStatusPage.clienttest.tsx+++ b/web/src/features/v4-migration/V4MigrationStatusPage.clienttest.tsx@@ -86,10 +86,14 @@ vi.mock("@/src/features/v4-migration/V4MigrationContent", () => ({),V4MigrationDeadlineNote: () => (<p>- After November 16, 2026 some features may stop working without a v4- upgrade.+ After November 16, 2026 some features may stop working if you don't+ update integrations.</p>),+ useV4MigrationTitle: () =>+ mocks.hasDeadline+ ? "Ensure compatibility after November 16"+ : "Ensure compatibility",}));vi.mock("@/src/features/posthog-analytics/usePostHogClientCapture", () => ({@@ -232,7 +236,9 @@ describe("V4MigrationStatusPage", () => {it("opens the summary card with a link to the v4 docs", () => {render(<V4MigrationStatusPage />);- expect(screen.getByText("Upgrade to v4")).toBeInTheDocument();+ expect(+ screen.getByText("Ensure compatibility after November 16"),+ ).toBeInTheDocument();expect(screen.getByRole("link", { name: "See docs." })).toHaveAttribute("href","https://langfuse.com/docs/v4",diff --git a/web/src/features/v4-migration/V4MigrationStatusPage.tsx b/web/src/features/v4-migration/V4MigrationStatusPage.tsxindex 259440d935..cbf45fc152 100644--- a/web/src/features/v4-migration/V4MigrationStatusPage.tsx+++ b/web/src/features/v4-migration/V4MigrationStatusPage.tsx@@ -16,6 +16,7 @@ import {import {useCopyMigrationPrompt,useHasV4MigrationDeadline,+ useV4MigrationTitle,V4MigrationDeadlineNote,V4MigrationDocsLink,V4_MIGRATION_DEADLINE,@@ -476,6 +477,7 @@ function V4MigrationStatusPageContent() {const session = useSession();const handleCopyPrompt = useCopyMigrationPrompt();const hasDeadline = useHasV4MigrationDeadline();+ const title = useV4MigrationTitle();const orgs: V4MigrationOrganization[] =session.data?.user?.organizations?.map((org) => ({@@ -627,11 +629,11 @@ function V4MigrationStatusPageContent() {><div className="flex flex-col gap-6 pt-2 pb-24"><Card className="flex min-w-0 flex-col gap-2.5 p-6">- <p className="text-base font-bold">Upgrade to v4</p>+ <p className="text-base font-bold">{title}</p><div className="text-muted-foreground flex flex-col gap-2 text-sm leading-relaxed"><p>{actionNeededProjects > 0- ? "Langfuse v4 is here: real-time ingestion and up to 165× faster queries. Complete the action items on each project below to switch over. "+ ? "Langfuse v4 is here: real-time ingestion and up to 165× faster queries. Complete the action items on each project below to avoid disruption. ": "Langfuse v4 is here: real-time ingestion and up to 165× faster queries. "}<V4MigrationDocsLink /></p>